{"uid":"cap_WlCG0kGa9hpLEf3ymzTX2","slug":"stableface-reverse-face-search-0818bb40","name":"StableFace Reverse Face Search","description":"Pay-per-request reverse face search powered by FaceCheck.id. Find every page on the web that contains a given face.","url":"https://stableface.dev/api/facecheck/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Image containing a face. Accepts a public http(s) URL or a data URL (data:image/...;base64,...) when you want to send bytes directly without hosting."},"limit":{"type":"integer","default":20,"maximum":200,"minimum":1,"description":"Maximum number of matches to return, ranked by score descending"},"minScore":{"type":"number","default":0,"maximum":100,"minimum":0,"description":"Drop matches with score below this threshold. 85+ is typically a strong match."},"testingMode":{"type":"boolean","default":false,"description":"Run in FaceCheck testing mode. Only scans ~100k faces, no credits consumed, but results are not meaningful. Use for integration tests only."},"includeThumbnails":{"type":"boolean","default":false,"description":"Include a base64 data-URI thumbnail of each matched face. Off by default since thumbnails dominate response size and are rarely useful to agents."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.2","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XurSIt2hID8LIuNdzzhpW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a reverse face search across the web to find every page containing a given face, powered by FaceCheck.id","exampleAgentPrompt":"Search FaceCheck.id for every webpage containing the face in this photo — https://example.com/person.jpg — return up to 50 results and only include matches with a score of 85 or higher.","exampleUseCases":null,"resultDescription":"A ranked list of web pages (up to the requested limit) where the face appears, each with a match confidence score from 0–100. Optionally includes base64-encoded face thumbnail crops. Results are sorted by score descending, filtered to only those meeting the minScore threshold.","failureModes":["No face detected in the provided image — returns empty results or error","Image URL is not publicly accessible or returns a non-image content type","Base64 data URL is malformed or too large","Score threshold too high — filters out all results, returning empty array","FaceCheck.id upstream unavailable — service error propagated","Payment not attached or insufficient USDC — x402 payment required error","Rate limit or quota exceeded on FaceCheck.id backend"],"whenToPreferThis":"Use this endpoint when you need to find where a specific person's face appears across the public web, identify an unknown individual from a photo, or audit the online presence of a face. Prefer this over text-based image search when the query is a face rather than an object or scene. Best for identity research, due diligence, or verification use cases where facial biometrics are the search key rather than metadata or text.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:32:56.111Z","isFirstParty":false}