Home/APIs/Face Analyzer

Computer VisionFree tier available

Detect, analyze, and recognize faces with AI

Advanced facial analysis API for face detection, age/gender/emotion estimation, celebrity recognition, face comparison, and custom face re-identification repositories. Scalable, low-latency, cloud-based.

Start Free on RapidAPI See Demo

Features

Face Detection

Detect multiple faces in a single image with precise bounding boxes and 7 facial landmarks.

Age, Gender & Emotion

Estimate age range, gender, smile, eyeglasses, sunglasses, and dominant emotion for each face.

Celebrity Recognition

Identify celebrities in images with name and reference URLs. Separates recognized and unrecognized faces.

Face Comparison

Compare faces from two images to find matches — perfect for verification and identity confirmation.

Face Repositories

Create custom face databases to store, manage, and search facial features for re-identification.

Cloud-Based & Scalable

Low latency, high availability. Analyze large volumes of images without managing any infrastructure.

API Reference

10 endpoints, simple integration. Here's everything you need.

Supported Content Types

multipart/form-dataapplication/x-www-form-urlencoded

POSThttps://faceanalyzer-ai.p.rapidapi.com/faceanalysis

Detect faces in an image with landmarks, gender, age range, smile, eyeglasses, sunglasses, and emotion estimation.

imagefilerequired

Image file to analyze — use with multipart/form-data

urlstringrequired

Public URL of the image — use with application/x-www-form-urlencoded

Send either image (file upload) or url, not both.

Response Schema

{
  "statusCode": 200,
  "faces": [
    {
      "boundingBox": { ... },
      "facialFeatures": {
        "Gender": "male",
        "Smile": true,
        "Eyeglasses": false,
        "Sunglasses": false,
        "AgeRange": [25, 35],
        "Emotions": ["HAPPY", 0.95]
      },
      "landmarks": {
        "eyeLeft": [x, y],
        "eyeRight": [x, y],
        "mouth": [x, y],
        "nose": [x, y],
        "browLeft": [x, y],
        "browRight": [x, y],
        "chinBottom": [x, y]
      }
    }
  ]
}

POSThttps://faceanalyzer-ai.p.rapidapi.com/celebrity-recognition

Recognize celebrities in an image. Returns celebrity names, info URLs, and facial features for each recognized face.

imagefilerequired

Image file to analyze — use with multipart/form-data

urlstringrequired

Public URL of the image — use with application/x-www-form-urlencoded

Send either image or url, not both.

Response Schema

{
  "statusCode": 200,
  "celebritiesFaces": [
    {
      "boundingBox": { ... },
      "facialFeatures": { ... },
      "landmarks": { ... },
      "celebrityName": "John Doe",
      "celebrityUrlsInfo": ["https://..."]
    }
  ],
  "unrecognizedFaces": [
    {
      "boundingBox": { ... },
      "facialFeatures": { ... },
      "landmarks": { ... }
    }
  ]
}

POSThttps://faceanalyzer-ai.p.rapidapi.com/compare-faces

Compare faces from two different images. Returns matched and unmatched faces from the target image.

source_imagefilerequired

Source face image file — use with multipart/form-data

source_image_urlstringrequired

Source face image URL — use with form-urlencoded

target_imagefilerequired

Target image to search for matching faces — file upload

target_image_urlstringrequired

Target image URL to search for matching faces

Send either source_image or source_image_url, and either target_image or target_image_url.

Response Schema

{
  "statusCode": 200,
  "matchedFaces": [
    { "boundingBox": { ... }, "landmarks": { ... } }
  ],
  "unmatchedFaces": [
    { "boundingBox": { ... }, "landmarks": { ... } }
  ]
}

POSThttps://faceanalyzer-ai.p.rapidapi.com/create-facial-repository

Create a custom facial repository to store facial features for re-identification.

repository_idstringrequired

Unique identifier for the new repository

Response Schema

{
  "statusCode": 200,
  "message": "OK"
}

POSThttps://faceanalyzer-ai.p.rapidapi.com/delete-facial-repository

Delete an existing facial repository and all its stored faces.

repository_idstringrequired

ID of the repository to delete

Response Schema

{
  "statusCode": 200,
  "message": "OK"
}

GEThttps://faceanalyzer-ai.p.rapidapi.com/list-facial-repositories

List all created facial repositories.

Response Schema

{
  "statusCode": 200,
  "FacialRepositoriesId": ["repo-1", "repo-2"]
}

POSThttps://faceanalyzer-ai.p.rapidapi.com/save-face-in-repository

Save a face's features from an image into a repository for later re-identification.

imagefilerequired

Image containing the face — use with multipart/form-data

urlstringrequired

Public URL of the image — use with form-urlencoded

repository_idstringrequired

ID of the target repository

external_idstringrequired

External identifier for the face (e.g. person name)

max_facesnumber

Maximum number of faces to save from the image

Send either image or url, not both.

Response Schema

{
  "statusCode": 200,
  "faces_id": ["face-id-1", "face-id-2"]
}

GEThttps://faceanalyzer-ai.p.rapidapi.com/list-repository-faces

List all faces stored in a specific repository.

repository_idstringrequired

ID of the repository (query string parameter)

Response Schema

{
  "statusCode": 200,
  "Faces": [
    { "FaceId": "...", "ExternalImageId": "..." }
  ]
}

POSThttps://faceanalyzer-ai.p.rapidapi.com/delete-face-from-repository

Delete one or more faces from a repository.

repository_idstringrequired

ID of the repository

face_idsarrayrequired

Array of face IDs to delete

Response Schema

{
  "statusCode": 200,
  "message": "OK"
}

POSThttps://faceanalyzer-ai.p.rapidapi.com/search-face-in-repository

Search for a face in a repository by providing an image. Returns matching faces with similarity scores.

imagefilerequired

Image containing the face to search — use with multipart/form-data

urlstringrequired

Public URL of the image — use with form-urlencoded

repository_idstringrequired

ID of the repository to search in

Send either image or url, not both.

Response Schema

{
  "statusCode": 200,
  "SearchedFaceBoundingBox": { ... },
  "FaceMatches": [
    {
      "Similarity": 98,
      "Face": {
        "FaceId": "...",
        "BoundingBox": { ... },
        "ExternalImageId": "..."
      }
    }
  ]
}

Response

200

Returns JSON with detected faces, facial features, landmarks, and endpoint-specific data (celebrity info, matches, repository entries).

Quick Start

Copy-paste code to get started in seconds. Replace YOUR_API_KEY with your RapidAPI key.

# Face Analysis
curl -X POST "https://faceanalyzer-ai.p.rapidapi.com/faceanalysis" \
  -H "x-rapidapi-key: YOUR_API_KEY" \
  -H "x-rapidapi-host: faceanalyzer-ai.p.rapidapi.com" \
  -F "image=@photo.jpg"

# Celebrity Recognition
curl -X POST "https://faceanalyzer-ai.p.rapidapi.com/celebrity-recognition" \
  -H "x-rapidapi-key: YOUR_API_KEY" \
  -H "x-rapidapi-host: faceanalyzer-ai.p.rapidapi.com" \
  -d "url=https://example.com/celeb.jpg"

# Compare Faces
curl -X POST "https://faceanalyzer-ai.p.rapidapi.com/compare-faces" \
  -H "x-rapidapi-key: YOUR_API_KEY" \
  -H "x-rapidapi-host: faceanalyzer-ai.p.rapidapi.com" \
  -F "source_image=@person1.jpg" \
  -F "target_image=@group.jpg"

# Search Face in Repository
curl -X POST "https://faceanalyzer-ai.p.rapidapi.com/search-face-in-repository" \
  -H "x-rapidapi-key: YOUR_API_KEY" \
  -H "x-rapidapi-host: faceanalyzer-ai.p.rapidapi.com" \
  -F "image=@person.jpg" \
  -F "repository_id=my-repo"

Pricing

Start free, scale as you grow. All plans include full API access with no credit card required for the free tier.

Free

Basic

$0Free

30 requests/mo

Full API access
All endpoints
Standard support

Pro

$12.99/mo

5,000 requests/mo

Full API access
All endpoints
Standard support

Recommended

Ultra

$22.99/mo

10,000 requests/mo

Full API access
All endpoints
Standard support

Mega

$92.99/mo

50,000 requests/mo

Full API access
All endpoints
Standard support

View Full Pricing on RapidAPI

Start Using Face Analyzer Today

Start for Free on RapidAPI