Skip to main content
FaceSearch REST API

Lancez des recherches de visages depuis n'importe quel langage

L'API REST FaceSearch offre aux développeurs une surface réduite et stable pour la recherche inversée d'image de visage : envoyez une photo, interrogez l'état, lisez les résultats. Authentification Bearer, reprises idempotentes et spécification OpenAPI publique.

Un endpoint • 3 crédits par recherche • Tout en JSON

La confiance de milliers de personnes dans le monde

15 000+ Recherches
50+ Pays
Cryptage 256 bits
99,7% de Précision

Fonctionnement de l'API REST

Trois étapes entre un terminal vide et votre premier résultat de recherche.

Créez une clé API
1

Créez une clé API

Connectez-vous au tableau de bord et générez une clé. Le texte en clair ne s'affiche qu'une seule fois. Stockez-la dans votre gestionnaire de secrets et ne la commitez jamais dans le code source.

Envoyez votre image en POST
2

Envoyez votre image en POST

Exécutez curl -F [email protected] https://facesearch.net/api/v1/search avec votre en-tête Bearer. L'endpoint renvoie un jobId en moins d'une seconde.

Interrogez jusqu'à la fin
3

Interrogez jusqu'à la fin

Appelez GET /api/v1/search/{jobId} toutes les 3 à 5 secondes. Quand le statut passe à completed, la réponse contient les URL sources, les miniatures et les scores de confiance.

Fonctionnalités de l'API REST

Tout ce qu'il vous faut pour intégrer la recherche de visage dans un backend en production.

REST API face search features visualization

Spécification OpenAPI 3.1

Un document OpenAPI rédigé à la main sur /api/v1/openapi.json, qui alimente tous les SDK typés, de l'import Postman aux clients générés dans plus de 20 langages.

Reprises idempotentes

Envoyez un en-tête Idempotency-Key conforme à la RFC 9110 et le serveur renvoie le même jobId pour les envois dupliqués. Sans l'en-tête, le serveur calcule automatiquement un hash du contenu, de sorte que les reprises naïves sont toujours sûres.

Quotas par clé

Chaque clé API peut porter un plafond quotidien et mensuel optionnel. Une clé compromise ne peut pas vider tout votre solde car le quota est appliqué à la vitesse de Redis, avec un repli sur Postgres.

Limites de débit granulaires

Chaque réponse transporte les en-têtes X-RateLimit-Remaining et X-RateLimit-Reset. Les réponses 429 incluent Retry-After pour vous indiquer exactement quand réessayer.

Pool de crédits partagé

L'usage de l'API puise dans le même solde que l'interface web. Une seule recharge dans le tableau de bord alimente les deux surfaces, sans nouveau SKU de facturation à gérer.

Erreurs prévisibles

Chaque réponse d'erreur est une enveloppe stable : code, message, status. Les codes comme INSUFFICIENT_CREDITS et RATE_LIMITED ne changent jamais, votre gestion d'erreurs peut donc rester ennuyeuse et éternelle.

Copiez. Collez. Déployez.

Chaque appel à l'API FaceSearch est une unique requête HTTP. Voici le même flux 'soumettre une recherche de visage' dans cinq langages.

Une seule ligne de 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"

Qui construit sur l'API REST

De la vérification d'antécédents aux outils de sécurité, l'API propulse les équipes qui ont besoin de recherche de visage à grande échelle.

Ingénieur backend intégrant l'API FaceSearch
Fintech

Pipelines de vérification d'identité

Les services KYC et d'onboarding appellent l'API depuis leur workflow de vérification afin de confirmer que la photo d'une pièce d'identité correspond bien à la personne ailleurs sur le web public.

Analyste Trust & Safety lançant des contrôles faciaux automatisés
Sécurité

Modération automatisée

Les équipes Trust & Safety connectent l'API à leur pipeline de réponse aux incidents pour enrichir les signalements escaladés de contexte en quelques secondes, au lieu de plusieurs heures.

Chercheur exécutant des recherches de visages en lot depuis un notebook
Recherche

Recherche d'investigation

Les journalistes d'investigation et chercheurs OSINT scriptent des recherches de visages en lot depuis des notebooks Jupyter, en utilisant l'en-tête de clé d'idempotence pour dédupliquer les lots lancés la nuit.

Plateforme de Recherche de Visage de Confiance

10M+
Recherches terminées
Des résultats fiables dans le monde entier
95%
Précision de correspondance
Propulsé par une IA avancée
50K+
Utilisateurs actifs
Une communauté grandissante
100M+
Sources scannées
Une couverture complète

Ce que les développeurs disent de l'API

Retours réels d'équipes qui intègrent FaceSearch dans leurs workflows de production.

"La politique hybride de clé d'idempotence est la meilleure que j'aie vue sur une API. Les reprises naïves fonctionnent tout simplement, et les clés explicites nous donnent un contrôle total quand il nous faut de vraies nouvelles recherches."
Priya R.
Staff Engineer, startup fintech
"Nous avons branché FaceSearch sur notre pipeline de modération en un après-midi. Les quotas par clé nous permettent de remettre à chaque équipe sa propre clé sans craindre qu'on vide la cagnotte par accident."
Marcus T.
Responsable Trust & Safety
"La spécification OpenAPI m'a permis de générer un client Python typé en une seule commande. Les codes d'erreur ne changent jamais, donc mon pipeline est d'une ennuyeuse stabilité depuis des mois, et c'est une qualité."
Yuki H.
Ingénieure de recherche

Tarification simple et transparente

Choisissez le plan qui correspond à vos besoins. Pas de frais cachés, annulez à tout moment.

FREE

$0/mois

Parfait pour commencer

LE PLUS POPULAIRE

PRO

$29/mois

Pour les professionnels et les utilisateurs intensifs

  • 100 Credits per month ($0.29 per credit)
  • Face Search
  • Search History
  • Can Export Profile to PDF
Paiement à l'acte

Ou achetez des packs de crédits

Starter

3crédits

$6

$2.00/credit

ÉCONOMISEZ 20%

Basic

30crédits

$24

$0.80/credit

ÉCONOMISEZ 31%

Standard

100crédits

$69

$0.69/credit

ÉCONOMISEZ 34%

Pro

300crédits

$199

$0.66/credit

ÉCONOMISEZ 40%

Enterprise

1000crédits

$599

$0.60/credit

FAQ de l'API REST

Tout ce que les développeurs demandent avant d'écrire leur première requête.

Commencez à construire avec l'API REST

Créez une clé API gratuite, collez le one-liner curl et lancez votre première recherche en moins de dix minutes.

Créer une clé API

No credit card required