DEVELOPER API

Face search,
as an API.

Send a face, get back ranked social-profile matches across 1B+ indexed images. Plain REST, JSON in, JSON out.

Base URL

https://api.facesnoop.com/v1

Auth

Send your key in the x-snoop-key header. Keep it server-side — never ship it in client code.

POST /v1/match

Find where a face appears. Send the photo as multipart image, or JSON { "image_url" } / { "image_base64" }.

Query parameters

ParamRangeDefaultDescription
top 1–100 24 Max number of matches to return.
min_percent 0–100 — Only return matches at or above this similarity %. May return zero.

Example request

curl -X POST "https://api.facesnoop.com/v1/match?top=24&min_percent=80" \
  -H "x-snoop-key: YOUR_API_KEY" \
  -F "image=@face.jpg"

Response

{
  "success": true,
  "results": [
    {
      "score": 91,
      "url": "https://instagram.com/jesse.rivera",
      "image_base64": "data:image/webp;base64,UklGR..."
    }
  ]
}

score is calibrated 0–100 (ArcFace cosine; ≥80 ≈ very likely the same person). url is the page the face was found on. On failure: { "success": false, "error": "no_face_detected_in_query" }.

POST /v1/remove

Request removal. Each URL is suppressed from all future search results.

Body

{ "urls": ["https://site.com/page", "https://site.com/other"] }

Response

{ "success": true, "removed": 2 }

Want an API key?

Tell us what you're building and we'll get you a key.

Request access