Aller au contenu principal
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.

Des milliers de recherches
Disponible dans le monde entier
Cryptage 256 bits
Haute précision des correspondances

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.

Ce avec quoi vous cherchez
Une photo contenant un visage. Il n'existe pas de recherche par mots-clés.
Ce que vous obtenez
Des pages classées où apparaît un visage correspondant, chacune avec un score de confiance et un lien vers la source.
Comment une correspondance est établie
Reconnaissance faciale. Le visage est converti en embedding — une liste de nombres — puis comparé par distance, et non par nom de fichier, légende ou pixels. Comment fonctionne la reconnaissance faciale ?
Coût par recherche
3 crédits. Les nouveaux comptes démarrent avec 3 crédits gratuits, sans carte bancaire.
Conservation des photos
Les téléversements sont supprimés dans les 24 heures suivant la fin de la recherche.
Qu'est-ce que la recherche faciale inversée ?

Fonctionnement de l'API REST

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

Créez une clé API

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

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

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.

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

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

10 Mo
Taille de chargement max
Images JPEG, PNG ou WebP
24 h
Conservation des images
Suppression automatique des envois
24h/24
Disponibilité de la recherche
Recherchez à tout moment
3
Crédits par recherche
Tarification simple et transparente

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.
Diego SalazarStaff 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.
Fatima ZahraResponsable 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é.
Henrik DahlIngé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

  • Recherche faciale
Commencer gratuitement
LE PLUS POPULAIRE

PRO

$29/mois

Pour les professionnels et les utilisateurs intensifs

  • 60 crédits par mois ($0.48 par crédit)
  • Recherche faciale
  • Historique de recherche
  • Exportation du profil en PDF possible

Ou achetez des packs de crédits

Paiement à l'acte

Starter

3crédits

$6

$2.00/crédit

ÉCONOMISEZ 20%

Basic

30crédits

$24

$0.80/crédit

ÉCONOMISEZ 31%

Standard

100crédits

$69

$0.69/crédit

ÉCONOMISEZ 34%

Pro

300crédits

$199

$0.66/crédit

ÉCONOMISEZ 40%

Enterprise

1000crédits

$599

$0.60/crédit

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

Aucune carte bancaire requise