> Une API de reconnaissance faciale pour la recherche par visage inversée. Envoyez une photo en POST, recevez les profils publics où ce visage apparaît avec un score de confiance pour chacun. Un crédit par recherche, sans abonnement, sans minimum mensuel. **API DE RECHERCHE PAR VISAGE IA** # RECHERCHE PAR VISAGE IA, DEPUIS VOTRE PROPRE CODE. Une **API de recherche par visage inversée** sur le web public. Envoyez une photo d'un visage, récupérez les pages et profils où il apparaît, chacun avec un score de confiance et un lien. Un crédit par recherche, facturé en dollars, sans abonnement et sans minimum mensuel. Pas d'appel commercial · Pas de minimum mensuel · Les crédits n'expirent jamais Aussi sur [RapidAPI](https://rapidapi.com/muratcankuruoffical/api/trace-reverse-face-search-api) · [spécification OpenAPI](https://traceaifacescan.app/openapi.json) · [exemples de code sur GitHub](https://github.com/muratcankuruoffical/reverse-face-search-api) · [Hugging Face Space](https://huggingface.co/spaces/muratcankuru/reverse-face-search) · [Apify Actor](https://apify.com/muratcankuru/reverse-face-search) - Résultats en environ une minute - Un crédit par recherche - REST + JSON, rien à installer - Notre propre moteur, pas un revendeur **CE QUE FAIT L'API** ## UNE PHOTO EN ENTRÉE. CHAQUE CORRESPONDANCE PUBLIQUE EN SORTIE. Le même moteur que celui du panel, avec les mêmes résultats. L'API n'est pas une version réduite. **RECHERCHE PAR VISAGE INVERSÉE** ### On compare un visage, pas un fichier. Une recherche d'image inversée classique trouve des copies de la même image. Ici, c'est le visage qui est comparé : une autre photo de la même personne — tenue différente, année différente — ressort tout de même comme résultat. **SCORE DE CONFIANCE** ### Chaque correspondance porte un chiffre. Chaque résultat a un score de similarité de 50 à 100 et une bande : possible à partir de 70, fort à partir de 80, quasi certain à partir de 90. Rien n'est renvoyé comme un verdict. **IDENTIFIANTS SOCIAUX** ### Le compte, pas seulement la page. Quand l'URL appartient à un compte, le pseudo et la plateforme reviennent dans des champs séparés — pas besoin de parser les URL de votre côté. **NOTRE PROPRE MOTEUR** ### Pas un revendeur. Trace gère son propre service de recherche par visage. C'est pourquoi une recherche coûte des centimes plutôt que des dollars, et pourquoi nous n'avons pas besoin de limiter vos requêtes. **DÉMARRAGE RAPIDE** ## TROIS APPELS, DU DÉBUT À LA FIN. L'authentification tient dans un en-tête. Aucun SDK à installer, aucune poignée de main. ### Lancer un scan Multipart, nom de champ `image`. JPEG, PNG ou WebP, jusqu'à 8 Mo, au moins 200 px sur le petit côté. `Idempotency-Key` est optionnel et sécurise une nouvelle tentative. ```bash curl -X POST https://traceaifacescan.app/api/v1/scans \ -H "Authorization: Bearer trk_live_..." \ -H "Idempotency-Key: $(uuidgen)" \ -F image=@face.jpg ``` **202 ACCEPTED** ```json { "id": "01m0jr1j5cbhwqsnt5qjx3zyd8", "status": "queued", "progress": 0, "locked": false, "match_count": 0, "credits_remaining": 9 } ``` ### Interroger jusqu'à la fin Une recherche dure environ 25 à 45 secondes. Interrogez toutes les une à deux secondes jusqu'à ce que `status` soit `done` ou `failed`. ```bash curl https://traceaifacescan.app/api/v1/scans/01m0jr1j5cbhwqsnt5qjx3zyd8 \ -H "Authorization: Bearer trk_live_..." ``` **200 OK** ```json { "status": "done", "progress": 100, "locked": false, "match_count": 2, "matches": [ { "score": 88, "tier": "strong", "platform": "x", "handle": "@alexrivers88", "url": "https://x.com/alexrivers88", "preview_url": ".../scans/01m0.../previews/0" } ] } ``` ### Dépenser le crédit Un scan créé sans crédit disponible revient `locked: true` sans correspondance — rien n'a été recherché. La révélation est un appel séparé, volontairement : un script qui parcourt une liste de scans ne doit pas pouvoir vider votre solde par accident. ```bash curl -X POST \ https://traceaifacescan.app/api/v1/scans/01m0.../reveal \ -H "Authorization: Bearer trk_live_..." ``` **POINTS DE TERMINAISON** ## TOUTE LA SURFACE. Sept points de terminaison. La définition lisible par machine se trouve sur [openapi.json](https://traceaifacescan.app/openapi.json), et la référence complète avec les corps de réponse est dans [la documentation](https://traceaifacescan.app/docs). - **POST** — `/v1/scans` — Démarrer un scan à partir d'une photo. - **GET** — `/v1/scans/{id}` — Statut, progression et correspondances. - **GET** — `/v1/scans` — Vos scans, paginés. - **POST** — `/v1/scans/{id}/reveal` — Dépenser un crédit et lancer la vraie recherche. - **GET** — `/v1/scans/{id}/previews/{n}` — La miniature du visage d'une correspondance. - **DELETE** — `/v1/scans/{id}` — Supprimer le scan, son image et ses aperçus. - **GET** — `/v1/account` — Votre solde de crédits. **ERREURS ET LIMITES** ## DES ÉCHECS PRÉVISIBLES. Les erreurs reviennent en `application/problem+json` avec une chaîne `code` stable. Vérifiez le code, jamais le message. - **402** — `insufficient_credits` — Plus aucun crédit. Rien n'a été recherché et rien n'a été débité. - **404** — `no_face_detected` — Aucun visage dans l'image. Une autre photo, pas une nouvelle tentative. - **429** — `rate_limited` — Seulement après des échecs d'authentification répétés. `Retry-After` indique quand. - **401** — `unauthorized` — Clé manquante, incorrecte ou révoquée. - **503** — `provider_unavailable` — De notre côté. Un crédit réservé pour une recherche échouée est toujours remboursé. ### Limites - **Aucune limite de débit sur les requêtes.** Les lectures ne sont pas comptées, et il n'y a pas de plafond par minute. - Votre vraie limite est votre **solde de crédits** : un scan coûte un crédit, une lecture ne coûte rien. - Images jusqu'à **8 Mo**, au moins **200 px** sur le petit côté. - Les scans et leurs images sont supprimés après **30 jours**. `DELETE` le fait immédiatement. **TARIFS** ## UN CRÉDIT, UNE RECHERCHE. Les mêmes crédits que ceux utilisés par le panel, issus du même solde. Pas d'abonnement, pas de minimum mensuel, et ils n'expirent jamais. Le pack de 100 crédits est celui autour duquel l'API est construite. Achetés par carte, avec Telegram Stars ou en cryptomonnaie — voir [les packs de crédits](https://traceaifacescan.app/fr/#pricing). Besoin d'un volume supérieur au plus grand pack ? [Écrivez-nous](https://docs.google.com/forms/d/e/1FAIpQLSdVeyYm3BLWkEnmHToK5_JQynOHCctKTxMkBJp3PJf-pmaLYQ/viewform). **LIMITES HONNÊTES** ## CE QUE CETTE API NE FERA PAS. **Ce n'est pas un service d'identité.** Une correspondance est un score de similarité entre deux images, pas une affirmation sur l'identité de quelqu'un. Il n'y a ni nom, ni adresse, ni numéro de téléphone, ni aucun type de dossier dans la réponse — seulement des URL publiques et un chiffre. **Un résultat vide n'est pas une preuve d'absence.** Cela signifie que rien n'a été trouvé sur la partie du web public que nous pouvons atteindre. Si la personne n'a aucune photo publique, il n'y a rien à trouver, et aucune API ne peut changer cela. **Rien derrière une connexion n'est touché.** Chaque résultat est une page déjà publique. **Elle ne doit pas être utilisée pour des vérifications d'antécédents, le recrutement, le crédit, l'assurance, la surveillance ou les forces de l'ordre**, et jamais contre des mineurs. N'envoyez que des photos que vous avez le droit de rechercher. C'est écrit dans les [Conditions d'utilisation](https://traceaifacescan.app/fr/conditions/) et nous l'appliquons — une clé utilisée de cette façon est révoquée. **FAQ** ## CE QUE LES DÉVELOPPEURS DEMANDENT EN PREMIER. ### Qu'est-ce qu'une API de recherche par visage par IA ? C'est une API HTTP qui prend une photographie d'un visage et renvoie les autres endroits de l'internet public où ce même visage apparaît. À la différence d'une recherche d'image inversée, qui compare des fichiers image, un scan facial par IA compare la géométrie du visage — elle reconnaît donc la même personne sur une photo complètement différente. La version de Trace est une API REST avec des réponses JSON : un POST pour démarrer un scan, un GET pour lire les correspondances. ### Combien coûte une recherche par visage via l'API ? Un crédit par recherche, et les crédits s'achètent en packs facturés en dollars américains — de 4 $ pour cinq crédits à 50 $ pour 100. Il n'y a ni abonnement, ni minimum mensuel, ni expiration. L'API dépense le même solde que le panel. ### Proposez-vous un palier gratuit ou un essai ? Il n'y a pas de recherche gratuite sur l'API. Une requête API venant d'un compte sans crédit crée le scan mais ne le recherche pas : il revient verrouillé, sans correspondance. Le panel montre à un visiteur connecté un exemple de résultat statique pour qu'il voie la forme d'un dossier terminé, et l'API ne renvoie volontairement jamais cela — un script pourrait construire quelque chose à partir d'un simple espace réservé. ### Quelle est la rapidité d'une recherche ? Environ 25 à 45 secondes de bout en bout, parfois jusqu'à 90. L'API est asynchrone pour cette raison : POST renvoie immédiatement 202 avec un identifiant, et vous l'interrogez. Garder une requête HTTP ouverte pendant une minute transformerait une connexion fermée en recherche annulée. ### Puis-je utiliser des URL d'images au lieu d'envoyer un fichier ? Pas en v1. Accepter une URL transformerait l'API en proxy SSRF — nous irions chercher des adresses arbitraires pour le compte d'un appelant depuis l'intérieur de notre réseau. Si cela arrive un jour, ce sera avec une liste blanche et un refus des plages privées. ### L'API est-elle limitée en débit ? Non. Appelez-la aussi vite que votre code le permet — les lectures ne sont pas comptées et il n'y a pas de plafond par minute. La seule chose qui vous limite est votre solde de crédits, car un scan coûte un crédit et une lecture ne coûte rien. Un seul garde-fou de sécurité subsiste et une clé valide ne le voit jamais : les tentatives d'authentification échouées répétées depuis la même adresse sont ralenties, pour que deviner des clés reste coûteux. ### Est-il légal d'utiliser une API de recherche par visage ? Cela dépend entièrement de ce que vous en faites et d'où vous êtes. Vérifier qu'une photo sur votre propre plateforme appartient bien à la personne qui l'utilise est très différent de constituer une base de données de visages. Les données faciales sont une catégorie spéciale sous le RGPD et le KVKK, et vous êtes le responsable du traitement pour tout ce que vous nous envoyez. Lisez les Conditions d'utilisation : vérifications d'antécédents, recrutement, crédit, assurance, surveillance et forces de l'ordre sont tous hors limites. ### Est-ce une API de reconnaissance faciale ou une API de recherche d'image inversée ? C'est une API de recherche par visage, qui est un type précis de reconnaissance faciale. Elle ne compare pas deux photos que vous fournissez, ne vérifie pas un document d'identité et ne renvoie rien sur qui est une personne. Elle prend une photographie et recherche sur le web public d'autres images du même visage, en renvoyant chaque correspondance comme une URL publique avec un score de similarité. C'est aussi ce qui la distingue d'une API de recherche d'image inversée : la recherche d'image inversée compare le fichier image, elle trouve donc des copies de cette image exacte, tandis que celle-ci compare la géométrie du visage et retrouve le même visage sur une photo différente. **API DE RECHERCHE PAR VISAGE IA** ## COMMENCEZ PAR UN SEUL APPEL. Créez une clé dans le panel et le premier curl fonctionne tout de suite.