/api/v1/face/analyzeExtract rich demographic and emotional attributes from a single API call. Estimate age, detect gender, recognise emotion, and predict ethnicity — all from one image.
REQUEST
curl -X POST https://api.faceguard.io/api/v1/face/analyze \ -H "X-API-Key: fg_live_your_key_here" \ -F "file=@face.jpg"
{
"age": 28,
"gender": { "value": "Man", "confidence": 0.94 },
"emotion": { "dominant": "happy", "scores": { "happy": 0.87, "neutral": 0.10 } },
"ethnicity": { "dominant": "asian", "confidence": 0.76 }
}Everything you need from a production-ready Facial Analysis API.
Returns estimated age as a numerical value, calibrated across global demographics.
Classifies gender with a confidence score for each prediction.
Detects 7 emotions: happy, sad, angry, surprised, fearful, disgusted, neutral.
Predicts ethnicity category with confidence scores across multiple groups.
Integrate in minutes with our developer-friendly REST API.
POST a clear front-facing face image to the analyze endpoint.
DeepFace models analyse the image for age, gender, emotion, and ethnicity independently.
Get all attributes in a single structured JSON response.
Data Output
All data returned as structured JSON — map directly to your database schema.
agegender.valuegender.confidenceemotion.dominantemotion.scoresethnicity.dominant{
"age": 28,
"gender": { "value": "Man", "confidence": 0.94 },
"emotion": { "dominant": "happy", "scores": { "happy": 0.87, "neutral": 0.10 } },
"ethnicity": { "dominant": "asian", "confidence": 0.76 }
}Create a free account. Get 50 test API requests instantly — no credit card required.