POST/api/v1/face/analyze

Deep Facial Analysis API

Extract rich demographic and emotional attributes from a single API call. Estimate age, detect gender, recognise emotion, and predict ethnicity — all from one image.

Get started free View API docs
POST /api/v1/face/analyze

REQUEST

█
200 OK
{
  "age": 28,
  "gender": { "value": "Man", "confidence": 0.94 },
  "emotion": { "dominant": "happy", "scores": { "happy": 0.87, "neutral": 0.10 } },
  "ethnicity": { "dominant": "asian", "confidence": 0.76 }
}

Key Features

Everything you need from a production-ready Facial Analysis API.

Age Estimation

Returns estimated age as a numerical value, calibrated across global demographics.

Gender Detection

Classifies gender with a confidence score for each prediction.

Emotion Recognition

Detects 7 emotions: happy, sad, angry, surprised, fearful, disgusted, neutral.

Ethnicity Prediction

Predicts ethnicity category with confidence scores across multiple groups.

How it works

Integrate in minutes with our developer-friendly REST API.

01

Upload face image

POST a clear front-facing face image to the analyze endpoint.

02

Multi-attribute AI

DeepFace models analyse the image for age, gender, emotion, and ethnicity independently.

03

Receive attributes

Get all attributes in a single structured JSON response.

Data Output

Fields You Can Extract

All data returned as structured JSON — map directly to your database schema.

age
gender.value
gender.confidence
emotion.dominant
emotion.scores
ethnicity.dominant
response.json
{
  "age": 28,
  "gender": { "value": "Man", "confidence": 0.94 },
  "emotion": { "dominant": "happy", "scores": { "happy": 0.87, "neutral": 0.10 } },
  "ethnicity": { "dominant": "asian", "confidence": 0.76 }
}

Mobile SDK

NO API KEY

Face Capture SDK

Capture a face image natively in your app and pass it to this endpoint. No API key needed for the capture itself.

Add to build.gradle.kts — Kotlin 2.0+:

Kotlin
dependencies {
    implementation("com.codelyticalhub:face-capture:1.0.0")
}
// settings.gradle.kts
repositories { mavenCentral() }

Manifest permission (runtime request handled by the SDK):

XML
<uses-permission android:name="android.permission.CAMERA" />

Quick start:

Kotlin
FaceCaptureSDK.register(this)  // in onCreate

FaceCaptureSDK.start(activity) { result ->
    when (result) {
        is FaceCaptureResult.Success -> {
            val file   = ImageUtils.bitmapToFile(context, result.bitmap)
            val base64 = ImageUtils.bitmapToBase64(result.bitmap)
            myBackend.callFaceGuardApi(file)  // never put API key in the app
        }
        FaceCaptureResult.Cancelled -> { }
        is FaceCaptureResult.Error  -> showError(result.message)
    }
}

⚠ Note

Never embed your FaceGuard API key in the app. Always proxy through your backend.
Full SDK docsAPI reference

Explore other APIs

Liveness Detection

Real-time anti-spoofing

Face Verification

Compare two faces with 4-model accuracy

Face Identification

Identify faces against enrolled users

Face Search

Search a face across a gallery

Face Embeddings

Extract base64 face vectors

Ready to integrate Facial Analysis?

Create a free account. Get 50 test API requests instantly — no credit card required.

Get started free Read the docs