/api/v1/face/searchUpload a probe face and a gallery of images. Receive ranked matches with filenames, distances, and per-model scores — perfect for forensics, attendance, and media tagging.
REQUEST
curl -X POST https://api.faceguard.io/api/v1/face/search \ -H "X-API-Key: fg_live_your_key_here" \ -F "query=@probe.jpg" \ -F "gallery=@person1.jpg" \ -F "gallery=@person2.jpg"
{
"matches": [
{ "filename": "person1.jpg", "distance": 0.24, "matched": true },
{ "filename": "person2.jpg", "distance": 0.61, "matched": false }
],
"query_processed": true
}Everything you need from a production-ready Face Search API.
Three models rank gallery images independently then results are fused for accuracy.
Matched gallery images are returned with their original filenames for easy lookup.
Submit up to dozens of gallery images per request. Results ranked by confidence.
Per-model distances returned alongside the fused result for full transparency.
Integrate in minutes with our developer-friendly REST API.
POST query (the face to find) and one or more gallery images in a single request.
Three models compute distances between the probe and every gallery image simultaneously.
Receive gallery images ranked by match confidence, closest first.
Data Output
All data returned as structured JSON — map directly to your database schema.
matches[].filenamematches[].distancematches[].matchedquery_processed{
"matches": [
{ "filename": "person1.jpg", "distance": 0.24, "matched": true },
{ "filename": "person2.jpg", "distance": 0.61, "matched": false }
],
"query_processed": true
}Create a free account. Get 50 test API requests instantly — no credit card required.