doesmybrandexist.io

API

Deux routes : l’une lance un scan de visibilité IA, l’autre relit un scan déjà fait. L’accès se fait sur clé — sans elle, l’API ne répond pas. La spécification complète est dans openapi.json.

Demander une clé

Chaque scan interroge de vraies IA et coûte de l’argent : la clé n’est pas une formalité, c’est ce qui rend l’API tenable. Dites-nous ce que vous voulez en faire et combien de marques vous suivez — c’est lu par un humain, et la réponse arrive en général sous 24 heures ouvrées.

Une clé donne un quota de scans par 24 heures, compté sur la clé et non sur votre adresse — un serveur qui appelle depuis une seule adresse n’est donc pas pénalisé. Besoin de plus ? Répondez à l’email qui vous l’a apportée.

Scanner une marque

POST /api/eclair/v1/scan, avec la clé dans l’en-tête x-api-key. Le champ s’appelle entree. La réponse porte le score, le détail par IA, et le jeton de la page de partage.

Donnez le site plutôt que le nom. Un domaine est unique ; un nom de marque peut avoir un homonyme, et l’IA répondra alors sur l’autre entreprise sans que rien ne le signale. Le nom seul reste accepté — "Garage Titi" fonctionne — mais c’est le moyen le plus sûr de mesurer quelqu’un d’autre que soi. Le https:// et le www. sont retirés tout seuls.

curl -X POST https://www.doesmybrandexist.io/api/eclair/v1/scan \
  -H "x-api-key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"entree": "garage-titi.fr"}'

import requests

r = requests.post("https://www.doesmybrandexist.io/api/eclair/v1/scan",
                  headers={"x-api-key": "VOTRE_CLE"},
                  json={"entree": "garage-titi.fr"})
print(r.json()["score"])

Une marque déjà scannée dans les vingt-quatre heures est resservie du cache — la réponse porte alors "cache": true, et elle ne consomme pas votre quota : elle n’a rien coûté.

Relire un scan

GET /api/eclair/v1/s/{jeton} — le jeton est celui de l’adresse de partage. Aucun appel d’IA n’est fait, donc aucun quota consommé. Réponse 404 si le scan n’existe pas.

curl -H "x-api-key: VOTRE_CLE" \
  https://www.doesmybrandexist.io/api/eclair/v1/s/VOTRE_JETON

Les réponses possibles

Code	Ce que ça veut dire
200	Le scan, ou sa relecture.
401	Aucune clé dans l’en-tête.
403	Clé inconnue, ou demandée mais pas encore accordée.
422	Corps illisible, ou champ `entree` vide.
429	Quota de la clé atteint sur 24 heures glissantes.
502	Aucune IA n’a répondu. Rien n’est facturé, rien n’est mis en cache.

Ce que le score veut dire

Chaque IA note elle-même sa connaissance de la marque, de 0 à 100, en une passe. Le score rendu est la moyenne de celles qui ont répondu — celles qui se sont tues figurent dans muettes. C’est un instantané déclaratif, pas une mesure répétée : la mesure suivie dans le temps, c’est le diagnostic geoscope.

← retour au scan