FaceSeek API

Upload an image (multipart form field file) and receive premium, deduplicated results across all enabled sources. Each successful call costs 10 API Tokens; 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
    }
  ],
  "api_tokens_remaining": 1480
}

score is a 0–100 match confidence, and results are ordered by it (highest first); image_url is a thumbnail (an http(s) or data: URL). api_tokens_remaining reflects your balance after the call.

Synchronous & slow: the call blocks until every source finishes and can take up to 5 minutes — set your HTTP client timeout to 300s. Results are live and best-effort, so the same photo can return different matches over time as the web changes; there is no caching. The call is not idempotent — on a network timeout, check /v1/api/account before retrying so you don't spend a second credit.

Upload an image (multipart form field file) and get an AI-generated / deepfake verdict. Each successful call costs 1 API Token (the same balance as face search); failed checks are not charged.

Request

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

Response

{
  "status": 200,
  "label": "deepfake",
  "verdict": "Likely a deepfake or face-swap",
  "ai_generated": 0.0123,
  "deepfake": 0.8742,
  "confidence": 0.8742,
  "top_generator": null,
  "top_generator_score": 0.0,
  "api_tokens_remaining": 1489
}

label is one of authentic, ai, deepfake, or uncertain. ai_generated and deepfake are 0–1 likelihoods; confidence is the headline score. top_generator names the closest AI generator when the image looks AI-made (else null). Detection is probabilistic — a strong signal, not proof.

Check the calling key's email and remaining balance of both products.

Request

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

Response

{
  "email": "you@company.com",
  "api_tokens_remaining": 1489
}