Face Search AI API
Reverse image and face search API. Submit any image and receive matching results from across the web.
Base URL https://client-api.facesearchai.com
Response format
All responses return application/json. Errors include an error field with a human-readable message.
Authentication
All endpoints except /health require an API key passed in the request header.
Enter your API key to test all endpoints on this page
Pass the key as X-API-Key: <your-key> or Authorization: Bearer <your-key>
Credits remaining
—
Endpoints
Click any endpoint to expand it and send a live request.
GET
/health
Check server status
No parameters · No authentication required
Try it
cURL
curl -s https://client-api.facesearchai.com/health
GET
/credits
Remaining credit balance
Headers
X-API-Key*
string
Your trial API key. Required.
Try it
X-API-Key — auto-filled from Authentication section
POST
/search
Reverse image & face search
Headers
X-API-Key*
string
Your API key. Required.
Content-Type*
string
Must be
application/json
Request body — provide one of the following
image_url
string
Publicly accessible URL of the image to search.
image_base64
string
Raw base64-encoded image (JPEG, PNG, WEBP). Do not include the data URI prefix.
Response fields
success
boolean
Whether the search returned results.
results
array
Array of match objects with
imageUrl and sourceUrl.
result_count
integer
Total number of matches returned.
credits_remaining
integer
Credits left after this request. 1 credit is deducted per call.
Try it
X-API-Keyimage_url optionalor upload a file
image_base64 (via file upload) optionalError codes
401
Missing or invalid API key.
402
No credits remaining. Contact support to top up.
422
Neither
image_url nor image_base64 provided.
500
Search failed. Credit automatically refunded.