FaceSeek API Documentation

Every request authenticates with a secret API key. To get one, email contact@faceseek.online with your account email — we provision a key and a prepaid call balance. Keys look like fsk_… and must be kept secret (server-side only).

Base URL

https://api.faceseek.online

Pass your key in the X-API-Key request header. Requests without a valid key return 401 Unauthorized.

X-API-Key: fsk_your_api_key_here

Upload an image (multipart form field file) and receive premium, deduplicated results across all enabled sources. Each successful call costs one credit; failed searches are not charged.

Request

curl -X POST https://api.faceseek.online/v1/api/search \
  -H "X-API-Key: fsk_your_api_key_here" \
  -F "file=@/path/to/face.jpg"

Response

{
  "status": 200,
  "results": [
    {
      "image_url": "data:image/jpeg;base64,...",
      "source_url": "https://example.com/profile",
      "domain": "example.com",
      "score": 94.2,
      "premium": true
    }
  ],
  "credits_remaining": 148
}

score is a 0–100 match confidence; image_url is a thumbnail (an http(s) or data: URL). credits_remaining reflects your balance after the call.

Check the calling key's email and remaining call credits.

Request

curl https://api.faceseek.online/v1/api/account \
  -H "X-API-Key: fsk_your_api_key_here"

Response

{ "email": "you@company.com", "credits_remaining": 148 }

• 401 — missing or invalid X-API-Key.
• 402 — out of credits. Top up or contact us.
• 502 — a transient search-backend error (not charged; retry).