Computer VisionFree tier available

Facial Recognition API — Detect, Analyze & Compare Faces

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 RapidAPISee 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,
  "body": {
    "faces": [
      {
        "boundingBox": { "topLeft": { "x": 0.28, "y": 0.12 }, "bottomRight": { "x": 0.72, "y": 0.85 } },
        "facialFeatures": {
          "Gender": "Male",
          "Smile": true,
          "Eyeglasses": false,
          "Sunglasses": false,
          "AgeRange": { "Low": 25, "High": 35 },
          "Emotions": ["HAPPY"]
        },
        "landmarks": {
          "eyeLeft": { "center": { "x": 0.38, "y": 0.40 } },
          "eyeRight": { "center": { "x": 0.62, "y": 0.40 } },
          "mouth": { "left": { "x": 0.40, "y": 0.70 }, "right": { "x": 0.60, "y": 0.70 } },
          "nose": { "center": { "x": 0.50, "y": 0.55 } }
        }
      }
    ]
  }
}
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,
  "body": {
    "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,
  "body": {
    "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,
  "body": {
    "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,
  "body": {
    "message": "OK"
  }
}
GEThttps://faceanalyzer-ai.p.rapidapi.com/list-facial-repositories

List all created facial repositories.

Response Schema
{
  "statusCode": 200,
  "body": {
    "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,
  "body": {
    "FacesId": ["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,
  "body": {
    "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,
  "body": {
    "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,
  "body": {
    "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

Frequently Asked Questions

What can the Face Analyzer API detect in an image?
The Face Analyzer API detects faces and returns detailed facial attributes including age range, gender, smile, eyeglasses, sunglasses, dominant emotion, and 7 facial landmarks. It also supports celebrity recognition, face comparison between two images, and custom face re-identification repositories.
How does the face comparison feature work?
The face comparison endpoint accepts a source image and a target image, then identifies whether the same person appears in both. It returns matched and unmatched faces with bounding boxes, making it ideal for identity verification, access control, and attendance systems.
Can I build a facial recognition system with this API?
Yes. The Face Analyzer API provides facial repository endpoints that let you create custom face databases, store facial features with external IDs, and search for matching faces by similarity score. This enables scalable face re-identification workflows without managing your own ML infrastructure.

Tutorials & Guides

Learn how to integrate this API with step-by-step tutorials and real-world use cases.

Face Matching in 5 Lines of Python: Detect, Encode, Compare
Deep Dive

Face Matching in 5 Lines of Python: Detect, Encode, Compare

How face matching works under the hood and how to implement it in 5 lines of Python. Covers face detection, embedding vectors, and similarity comparison with real test results.

Read article
Verify User Identity with a Face Comparison API
Tutorial

Verify User Identity with a Face Comparison API

Verify user identity by comparing a selfie against an ID photo with a face comparison API. Covers KYC, profile verification, and fraud prevention.

Read article
Build Face-Based Access Control with a Comparison API
Tutorial

Build Face-Based Access Control with a Comparison API

Build a facial recognition access control system with a face comparison API. Covers enrollment, verification, and repository management.

Read article
Building a Face Detection App with a REST API
Tutorial

Building a Face Detection App with a REST API

Step-by-step tutorial for building a face detection application using a REST API. Includes cURL, Python, and JavaScript code examples with the Face Analyzer API.

Read article

Start Using Face Analyzer Today

Sign up on RapidAPI to get your API key. The free tier includes generous monthly requests — no credit card required.

Start for Free on RapidAPI