Fintech
Identitätsprüfungs-Pipelines
KYC- und Onboarding-Dienste rufen die API aus ihrem Verifizierungs-Workflow auf, um zu bestätigen, dass das Foto auf einem eingereichten Ausweis mit der Person an anderer Stelle im öffentlichen Web übereinstimmt.
FaceSearch REST API
Gesichtersuche aus jeder Sprache auslösen
Die FaceSearch REST API bietet Entwicklern eine schlanke, stabile Oberfläche für die umgekehrte Gesichtsbildsuche: Foto hochladen, Status abfragen, Ergebnisse lesen. Bearer-Token-Auth, idempotente Retries und eine öffentliche OpenAPI-Spezifikation.
Ein Endpunkt • 3 Credits pro Suche • Durchgängig JSON
Von Tausenden weltweit vertraut
15.000+ Suchen
50+ Länder
256-Bit-Verschlüsselung
99,7% Genauigkeit
So funktioniert die REST API
Drei Schritte vom leeren Terminal zum ersten Suchergebnis.
1
API-Schlüssel anlegen
Im Dashboard anmelden und einen Schlüssel erzeugen. Der Klartext wird genau einmal angezeigt. Speichern Sie ihn im Secrets-Manager und committen Sie ihn niemals ins Repository.
2
Bild per POST senden
curl -F [email protected] https://facesearch.net/api/v1/search mit dem Bearer-Header ausführen. Der Endpunkt liefert binnen einer Sekunde eine jobId zurück.
3
Bis zum Abschluss abfragen
Alle 3 bis 5 Sekunden GET /api/v1/search/{jobId} aufrufen. Sobald der Status completed lautet, enthält die Antwort die Quell-URLs, Thumbnails und Confidence-Scores.
Funktionen der REST API
Alles, was Sie brauchen, um Gesichtersuche in ein produktives Backend zu integrieren.
Funktionen der REST API
Alles, was Sie brauchen, um Gesichtersuche in ein produktives Backend zu integrieren.
OpenAPI 3.1 Spezifikation
Ein handgepflegtes OpenAPI-Dokument unter /api/v1/openapi.json, das jedes typensichere SDK antreibt — vom Postman-Import bis zu generierten Clients in 20+ Sprachen.
Idempotente Retries
Senden Sie einen Idempotency-Key-Header gemäß RFC 9110 und der Server liefert für doppelte Einreichungen dieselbe jobId. Ohne Header leitet der Server automatisch einen Content-Hash ab, sodass naive Retries stets sicher sind.
Kontingente pro Schlüssel
Jeder API-Schlüssel kann ein optionales Tages- und Monatslimit tragen. Ein geleakter Schlüssel kann Ihr Guthaben nicht leeren, weil das Kontingent mit Redis-Geschwindigkeit durchgesetzt wird und ein Postgres-Fallback existiert.
Granulare Rate Limits
Jede Antwort enthält die Header X-RateLimit-Remaining und X-RateLimit-Reset. 429-Antworten liefern Retry-After, sodass Sie präzise wissen, wann Sie es erneut versuchen können.
Gemeinsamer Credit-Pool
Die API nutzt denselben Credit-Pool wie die Web-Oberfläche. Eine einmalige Aufladung im Dashboard versorgt beide Welten, ohne neue Abrechnungs-SKU.
Berechenbare Fehler
Jede Fehlerantwort ist ein stabiler Umschlag: code, message, status. Codes wie INSUFFICIENT_CREDITS oder RATE_LIMITED ändern sich nie, Ihre Fehlerbehandlung darf langweilig und zeitlos bleiben.
Kopieren. Einfügen. Ausliefern.
Jeder Aufruf der FaceSearch-API ist eine einzige HTTP-Anfrage. Hier ist derselbe Ablauf 'Gesichtssuche einreichen' in fünf Sprachen.
Einzeiler im Terminal
# 1. Submit a face image for search
curl -X POST https://facesearch.net/api/v1/search \
-H "Authorization: Bearer fs_live_YOUR_KEY" \
-H "Idempotency-Key: submit-$(date +%s)" \
-F "image=@/path/to/face.jpg" \
-F "consent=true"
# 2. Poll for completion
curl https://facesearch.net/api/v1/search/JOB_ID \
-H "Authorization: Bearer fs_live_YOUR_KEY"
# 3. Check your credit balance
curl https://facesearch.net/api/v1/credits \
-H "Authorization: Bearer fs_live_YOUR_KEY"Wer auf der REST API aufbaut
Von Background-Checks bis zu Safety-Tooling: Die API treibt Teams an, die Gesichtersuche in großem Maßstab brauchen.
Safety
Automatisierte Moderation
Trust-&-Safety-Teams verdrahten die API mit ihrer Incident-Response-Pipeline, sodass eskalierte User-Reports in Sekunden statt in Stunden mit Kontext angereichert werden.
Research
Investigative Recherche
Investigativjournalisten und OSINT-Forscher skripten Bulk-Suchen aus Jupyter-Notebooks und nutzen den Idempotency-Key-Header, um Batch-Läufe über Nacht zu deduplizieren.
Vertrauenswürdige Gesichtssuch-Plattform
10M+
Abgeschlossene Suchen
Vertrauenswürdige Ergebnisse weltweit
95%
Treffergenauigkeit
Angetrieben von fortschrittlicher KI
50K+
Aktive Benutzer
Wachsende Gemeinschaft
100M+
Gescannte Quellen
Umfassende Abdeckung
Was Entwickler über die API sagen
Echtes Feedback von Teams, die FaceSearch in produktive Workflows integrieren.
"Die hybride Idempotency-Key-Policy ist die beste, die ich bei einer API je gesehen habe. Naive Retries funktionieren einfach, und explizite Keys geben uns volle Kontrolle, wenn wir wirklich frische Suchen brauchen."
"Wir haben FaceSearch an einem Nachmittag in unsere Moderationspipeline eingebunden. Dank der Kontingente pro Schlüssel können wir verschiedenen Teams eigene Keys geben, ohne dass jemand versehentlich den Pool leert."
"Aus der OpenAPI-Spezifikation habe ich mit einem Befehl einen typisierten Python-Client generiert. Fehlercodes ändern sich nie, meine Pipeline ist seit Monaten langweilig — im besten Sinne."
Einfache, transparente Preise
Wählen Sie den Plan, der zu Ihren Bedürfnissen passt. Keine versteckten Gebühren, jederzeit kündbar.
BELIEBTESTE
PRO
$29/Monat
Für Profis und Power-User
- 100 Credits per month ($0.29 per credit)
- Face Search
- Search History
- Can Export Profile to PDF
Pay as you go
Oder Credit-Pakete kaufen
Starter
3Credits
$6
$2.00/credit
SPAREN 20%
Basic
30Credits
$24
$0.80/credit
SPAREN 31%
Standard
100Credits
$69
$0.69/credit
SPAREN 34%
Pro
300Credits
$199
$0.66/credit
SPAREN 40%
Enterprise
1000Credits
$599
$0.60/credit
REST API FAQ
Alles, was Entwickler fragen, bevor sie den ersten Request schreiben.
Jetzt mit der REST API loslegen
Erstellen Sie einen kostenlosen API-Schlüssel, fügen Sie den curl-Einzeiler ein und führen Sie Ihre erste Suche in unter zehn Minuten aus.
API-Schlüssel erstellen
No credit card required
