API as a service

Face search, straight from your code.

Same engine as the web. REST endpoint, X-API-Key auth, JSON in your inbox in a second. Pay per month for credits, top up any time, cancel any time.

Get an API key See endpoints

terminal · cURL

1$ curl -X POST https://api-v2.facesearchai.com/api/v1/api-service/search \
2    -H "X-API-Key: $FSAI_KEY" \
3    -F "file=@photo.jpg"
4
5→ 200 OK · 8 matches · 49 credits left

Endpoints

Five routes. That's the whole API.

Send your key in the X-API-Keyheader. Base URL https://api-v2.facesearchai.com.

POST/api/v1/api-service/searchRun a reverse face search. Multipart file or image URL. Spends 1 credit.Core

GET/api/v1/api-service/keysList your API keys with current credit balance (no secrets returned).

POST/api/v1/api-service/keysGenerate a new API key. Maximum one active key per account.

DEL/api/v1/api-service/keys/{id}Revoke an active key. Takes effect immediately.

POST/api/v1/api-service/checkoutStart Stripe checkout for an API subscription plan.

Response

One predictable JSON shape.

Every search returns matches, a credit balance, and a share id you can pass back to your users.

response.json · 200 OK

{
  "status": "success",
  "results_count": 8,
  "share_id": "qx7-9fa2",
  "credits_remaining": 49,
  "results": [
    {
      "url": "https://example.com/profile/42",
      "image_url": "https://cdn.example.com/p/42.jpg",
      "score": 0.9421,
      "source": "public-web"
    }
    /* ... 7 more */
  ]
}

Pricing

Per-credit, no contracts.

Subscribe for monthly credits, top up when you run low. Top-up credits don't expire while the subscription is active.

Monthly

API Starter

$50/ month

100 API credits / month

100 face searches per month
X-API-Key auth, JSON response
60 requests / minute
Cancel any time

Top-up pack

$20one-time

40 extra credits · $0.50/search

40 additional API credits
Added to your existing balance
Spent after monthly credits
Requires an active subscription

Top up credits

How it works

Three steps to your first match.

Step 01

Pick a plan and check out with Stripe. Your account gets a fresh credit balance the moment payment clears.

Step 02

Generate key

One active key per account. Created from your dashboard, shown to you only once. Store it in a secrets manager.

Step 03

Search

POST an image, get JSON. Credits decrement automatically. Same engine as the web search, same response shape.

Enterprise

Custom volume, dedicated quota.

Talk to us if you need higher rate limits, on-prem deployment, a signed DPA, an SLA, or volume discounts. We work with investigators, journalists, marketplaces, and trust & safety teams.

Higher rate limits and custom quotas
Signed DPA and security review
VPC / on-prem deployment options
Custom SLAs and dedicated support
Volume discounts on credits and top-ups