Skip to main content

Face Recognition API
for Developers

Add powerful facial recognition to your app in minutes. Queue processing, selfie matching, and intelligent metadata search.

Get Started Free View Documentation
$ Quick Start
curl -X POST https://api.facehub.cloud/v1/queue \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"app":"myapp","tag":"event","urls":["https://example.com/photo.jpg"]}'
Feature Rich API

Powerful Features

Everything you need for face recognition at scale

Batch Queue Processing

Queue thousands of images for processing. Async workers handle face detection, embedding extraction, and metadata parsing automatically.

Selfie Matching

Find all images containing a specific person. Upload a selfie and search across your entire image database with adjustable similarity thresholds.

Metadata Search

Query by EXIF data (camera, location, date) and IPTC metadata (keywords, captions). Combine face search with rich metadata filtering.

512D Face Embeddings

Get high-dimensional face embeddings for your ML pipelines. State-of-the-art model provides exceptional accuracy for face detection and recognition.

Real-time Status

Monitor your queued, processing, and completed tasks. Track usage metrics and billing in real-time through the API.

Secure & Multi-tenant

API key authentication with tenant isolation. Your data stays private. Free tier for development, pay-as-you-go for production.

Live API Playground

Try It Live

Experience the power of our API with real-time interactive examples. No signup required.

Count Faces

Detect and count the number of faces in an image. Perfect for analytics and automation.

Face recognition API detecting multiple faces in group photo - FaceHub demo

Sample image for testing

POST /v1/count
{ "app": "demo", "url": "https://images.unsplash.com/photo-1615561479656-46419d14de5a" }

API Response

Click "Execute API Call" to see the response

Real-time API execution

Using Free Demo API Key

Active

These examples use the free demo API key: 12345678-ABCD-APIKEY-FREE

Add it to your requests using the Authorization: Bearer YOUR_API_KEY header.

Get your own API key
Complete API Reference

API Endpoints

RESTful API with comprehensive face recognition capabilities. All endpoints require Bearer token authentication.

POST

/v1/queue

Queue multiple images for batch processing. Extracts faces, embeddings, EXIF, and IPTC metadata for each image asynchronously.

Request Parameters

app
string · required

Application identifier for organizing images within your tenant

Example: "wedding-portal"
tag
string · required

Category tag to group related images

Example: "event-photos"
urls
array · required

Array of image URLs to process

Request Body JSON
{
  "app": "myapp",
  "tag": "event-photos",
  "urls": [
    "https://example.com/photo1.jpg",
    "https://example.com/photo2.jpg"
  ]
}
POST

/v1/selfie

Search for all images containing a specific person by providing a selfie URL. Matches faces across your queued images with adjustable similarity thresholds.

Request Parameters

app
string · required

Application identifier (must match the app used when queuing)

url
string · required

URL of the selfie/reference image to search for

tags
array · optional

Array of tags to limit search scope. If omitted, searches all images in the app

threshold
number · optional

Similarity threshold (0-100). Higher = stricter matching

Default: 60
Request Body JSON
{
  "app": "myapp",
  "url": "https://example.com/selfie.jpg",
  "tags": ["event-photos"],
  "threshold": 60
}
POST

/v1/iptc/search

Search queued images by IPTC metadata fields. Filter by photographer, location, keywords, and more. Combine with face search for powerful queries.

Request Parameters

app
string · required

Application identifier (must match app used when queuing)

tag
string · required

Tag to filter by (from the tag assigned during queue)

key
string · required

IPTC field name to search (see available fields below)

text
string · required

Search text to match within the specified IPTC field

Available IPTC Fields (15 fields)
Keywords
Object Name
Caption
Headline
City
Province/State
Country
Photographer
Byline
Credit
Source
Copyright Notice
Date Created
Location
Category
Request Body JSON
{
  "app": "myapp",
  "tag": "event-photos",
  "key": "Keywords",
  "text": "wedding"
}

Additional Endpoints

POST /v1/embeddings Get 512D face embeddings from image
POST /v1/count Count number of faces in image
POST /v1/draw Draw bounding boxes on detected faces
GET /v1/usage/{year}/{month} View usage metrics for specific month
GET /v1/billing/{year}/{month} View billing summary for specific month

Authentication

All endpoints require Bearer token authentication via the Authorization header.

Authorization: Bearer YOUR_API_KEY
Flexible Pricing

Simple, Transparent Pricing

Start free, scale as you grow. All endpoints unlimited except queue processing.

Free Tier

€0 /month

Perfect for testing and development

Queue Processing

100 images/month via /v1/queue

All Other Endpoints

Unlimited & Free forever

count, draw, embeddings, selfie, search, usage

  • Access to all API endpoints
  • No credit card required
  • Community support
  • Instant API key generation
Start Free
Recommended

Pay-as-you-go

€9.99 /month

Best for production applications

Queue Processing

10,000 images/month included

Then only €0.01 per additional image

All Other Endpoints

Unlimited & Free forever

count, draw, embeddings, selfie, search, usage

  • Everything in Free tier
  • Priority email support
  • Real-time usage dashboard
  • Production-ready SLA
Get Started Now

Pricing Clarification

Metered Endpoint

/v1/queue - Batch processing is metered

Unlimited Endpoints

All other endpoints are free with no limits

No hidden fees. Cancel anytime. Billing starts only when you exceed free tier limits.

Instant Setup

Get Your API Key

Start building in seconds. Choose your plan and get instant access to our face recognition API.

Free Tier Benefits

  • 100 queue requests/month
  • All other endpoints unlimited & free
  • No credit card required

Your email is secure. We'll never share it with anyone.

SSL Encrypted
GDPR Compliant
99.9% Uptime
Real-World Applications

Built for Every Use Case

From event photography to security systems, discover how developers are using FaceHub API

Event Photography

Upload thousands of photos from weddings, concerts, or sports events. Guests find their pictures instantly by uploading a selfie. Perfect for photographers and event organizers.

Queue Processing Face Search

Access Control

Build secure facial recognition systems for offices, gyms, or residential buildings. Real-time verification with high accuracy and fast response times.

Face Detection Embeddings

Attendance Tracking

Automate attendance for schools, offices, or events. Quick check-ins with selfie verification. Replace manual sign-ins with smart facial recognition.

Selfie Match Real-time

Social Platforms

Auto-tag friends in photos, suggest profile pictures, or enable face-based search. Enhance user experience with intelligent face recognition features.

Face Count Metadata

Photo Management

Build smart photo galleries that organize by faces. Search your entire photo library by person. Automatic album creation based on who appears in photos.

IPTC Search Face Search

Visitor Analytics

Track unique visitors in retail stores or venues. Analyze foot traffic patterns and customer behavior. Privacy-compliant demographic insights.

Detection Analytics

Ready to build your solution?

Start Building Now
Trusted by Developers Worldwide

What Developers Say

Join hundreds of developers building amazing applications with our face recognition API

"The API integration was seamless. We went from prototype to production in just two days. The queue processing feature is a game-changer for handling bulk uploads."

"Outstanding accuracy and speed. The selfie matching API helped us build a robust attendance system. Documentation is clear and support team is responsive."

"Best face recognition API I've worked with. The embeddings endpoint gives us flexibility to build custom solutions. Pricing is transparent and fair."

"Incredible value for money. The free tier was perfect for testing, and scaling to production was effortless. The face detection accuracy exceeded our expectations."

"Simple REST API that just works. We integrated it into our mobile app in hours. The IPTC metadata search is a unique feature that saved us development time."

"Reliable and fast performance. We process thousands of images daily without any hiccups. The API uptime is excellent and response times are consistently quick."

"Excellent developer experience. The code examples are clear, error messages are helpful, and the API responses are well-structured. Highly recommended."

"The face detection algorithm is impressively accurate even with difficult lighting conditions. Integration took less than an hour. Great API for production use."