v2.4 API Live

Build the Future of Beauty Tech.

One powerful API to rule facial geometry, skin diagnostics, and personalized style recommendations. Integrate in minutes.

Introduction

Welcome to the Face Shape Detector API. We provide developers with access to advanced computer vision models for facial analysis. Our API is RESTful, returns JSON-encoded responses, and uses standard HTTP response codes.

Base URL

https://api.faceshapedetector.tools/v1

Content-Type

application/json

Authentication

The API uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard.

bash 
curl -X GET https://api.faceshapedetector.tools/v1/user \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Warning: Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.
POST

Detect Face Shape

Analyzes an uploaded image to categorize the user's face shape (Oval, Round, Square, Oblong, Heart, Diamond). It also provides a confidence score and bounding box coordinates.

Body Parameters

Param Type Description
image_url string Public URL of the image.
image_base64 string Base64 encoded string (alternative).
return_landmarks boolean If true, returns 68-point landmarks. 
curl -X POST https://api.faceshapedetector.tools/v1/detect \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://img.com/me.jpg",
    "return_landmarks": true
  }'
Response 200 OK 
{
  "status": "success",
  "data": {
    "shape": "Oval",
    "confidence": 0.98,
    "bbox": [102, 45, 300, 400]
  }
}
POST

Skin Health Analysis

Returns dermatological insights including skin tone (Fitzpatrick scale), undertone, acne severity score, and texture analysis. 

// Example Response Payload
{
  "data": {
    "skin_tone": {
        "hex": "#E0AC69",
        "name": "Medium Light"
    },
    "undertone": "Warm",
    "concerns": [
        { "type": "Acne", "severity": "Low", "score": 15 },
        { "type": "Dark Circles", "severity": "Medium", "score": 45 }
    ]
  }
}

API Plans

Hobby

$0 /mo

For testing and personal projects.

  • 100 Calls / month
  • Face Shape Only
  • 1 Req / sec
POPULAR

Startup

$49 /mo

For growing apps and businesses.

  • 10,000 Calls / month
  • All 14 AI Engines
  • Priority Support

Enterprise

Custom

High volume and SLA needs.

  • Unlimited Calls
  • Dedicated GPU
  • SLA Guarantee