Documentation de l'API

Échantillon gratuit (sans clé)

Renvoie quelques boutiques : 10 par défaut, 20 au plus. Pour voir la forme des données avant de vous abonner. Ne compte pas dans le quota.

curl "https://api.ecommerce-leads-database.com/v1/sample?limit=10"

Votre plan et votre quota

Renvoie votre plan, vos requêtes et boutiques utilisées, vos bases et la date de remise à zéro. Gratuit : ne consomme ni requête ni boutique.

curl https://api.ecommerce-leads-database.com/v1/me \
  -H "X-API-Key: eldb_live_…"

{
  "plan": "api_pro",
  "planLabel": "Pro",
  "requests": { "limit": 25000, "used": … },
  "stores": { "limit": 10000, "used": … },
  "databases": { "slots": 3, "selected": ["shopify", "woocommerce", "prestashop"] },
  "exports": true,
  "resetAt": "…"
}

Compter les boutiques

Renvoie le nombre de boutiques qui correspondent aux filtres, et combien ont une fiche Google. Coûte 1 requête et 0 boutique.

Paramètres : platform, tld, country, hasGmb, hasEmail, hasPhone, app, currency, lang, operatorCountry, activeOnly, genericEmailsOnly, includeUnverified, includeAliases, maxChromeRank, mailProvider, dmarcPolicy, trackingId, hasDecisionMaker, hasDecisionMakerEmail

curl "https://api.ecommerce-leads-database.com/v1/stores/count?platform=shopify" \
  -H "X-API-Key: eldb_live_…"

{ "count": 29331, "gmbCount": 6511 }

Chiffres réels pour les boutiques Shopify vérifiées.

Chercher des boutiques

Filtre la base et renvoie une page de résultats (items) avec un curseur (nextCursor).

Paramètres : platform, tld, country, minProducts, hasGmb, hasEmail, hasPhone, app, currency, lang, operatorCountry, activeOnly, genericEmailsOnly, includeUnverified, includeAliases, maxChromeRank, mailProvider, dmarcPolicy, trackingId, hasDecisionMaker, hasDecisionMakerEmail, cursor, limit

• limit : de 1 à 100 résultats par page. 50 par défaut.
• Tri : du plus fort trafic au plus faible. Les boutiques sans trafic connu arrivent en dernier.
• Par défaut, search et count ne renvoient que les boutiques vérifiées : une vraie boutique en ligne, revérifiée sur son site. Ajoutez includeUnverified=true pour inclure aussi les sites vitrines et les sites injoignables.
• activeOnly vaut true par défaut : les boutiques notées inactives sont exclues. Ajoutez activeOnly=false pour les inclure.
• Filtres : hasEmail (email collecté dans les 12 derniers mois), hasPhone, app (une app détectée, ex. Klaviyo), currency (EUR), lang (fr), operatorCountry (FR), genericEmailsOnly (avec hasEmail : adresses génériques seulement). Une valeur invalide renvoie 400 invalid_parameter et la requête n'est pas décomptée.
• maxChromeRank (palier maximal du classement Chrome UX Report : 1000, 5000, 10000, 50000, 100000, 500000, 1000000, 5000000, 10000000 ou 50000000). Toute autre valeur renvoie 400 invalid_parameter. Le champ audience contient des données du Chrome UX Report (Google), sous licence CC BY-SA 4.0.
• mailProvider (fournisseur de messagerie déduit du MX : google-workspace, microsoft-365, ovh, infomaniak, ionos, gandi, zoho, proton, o2switch, hostinger, other, none) et dmarcPolicy (none, quarantine, reject ou missing). Toute autre valeur renvoie 400 invalid_parameter. Le filtre app trouve aussi les outils lus dans le DNS (par exemple Klaviyo via SPF). Slugs d'apps que le DNS peut ajouter : klaviyo, mailchimp, brevo, shopify email, mailjet, sendgrid, hubspot, salesforce marketing cloud, omnisend, mandrill, amazon ses, zendesk, mailgun, meta business, google site verification, pinterest, apple, atlassian, zoom, stripe, shopify.
• Codes de suivi publics : utilisez trackingId pour retrouver les autres boutiques qui partagent un même code. Passez une valeur seule comme GTM-ABC123, AW-123456789, G-ABCDEF1234, UA-1234567-1 ou ca-pub-1234567890123456. Les codes numériques demandent leur type devant : meta:123456789012345, tiktok:…, pinterest:…, microsoftAds:…, linkedin:…, hotjar:…, criteo:…, snapchat:…, clarity:…, klaviyo:… (Klaviyo distingue majuscules et minuscules). Toute autre valeur renvoie 400 invalid_parameter. Chaque résultat contient aussi trackingIds (null tant que la boutique n'a pas été lue).
• hasDecisionMaker=true|false (au moins un dirigeant connu, ou aucun) et hasDecisionMakerEmail=true (au moins un dirigeant dont l'email a été trouvé sur le site ou validé par le serveur de messagerie). Toute autre valeur renvoie 400 invalid_parameter. Chaque résultat contient aussi hasDecisionMaker.
• Page suivante : renvoyez la valeur de nextCursor dans le paramètre cursor. À la dernière page, nextCursor vaut null.
• Chaque boutique renvoyée compte dans votre budget boutiques. Une page de 50 résultats consomme 50 boutiques.
• Chaque résultat est un résumé de boutique : domaine, plateforme, pays, thème, nombre de produits, apps, trafic, nom du marchand, note et catégorie Google, hasEmail, hasPhone, hasDecisionMaker, currency, lang, operatorCountry, isActiveShop. Chaque résultat contient aussi audience (null si la boutique n'est pas dans le classement Chrome UX Report). Chaque résultat contient aussi dns (null tant que la boutique n'a pas été lue). Pour la fiche complète, appelez /v1/stores/:domain.

curl -G https://api.ecommerce-leads-database.com/v1/stores/search \
  -H "X-API-Key: eldb_live_…" \
  -d platform=shopify \
  -d minProducts=50 \
  -d hasGmb=true \
  -d limit=50

{
  "items": [
    { "domain": "…", "platform": "shopify", "productCount": …, "merchantName": "…", … }
  ],
  "nextCursor": "18450:01J…"
}

Fiche d'une boutique

Renvoie la fiche complète d'une boutique. Coûte 1 requête et 1 boutique. Le catalogue n'est pas inclus : utilisez /catalog. Chaque email est renvoyé avec son type ; ajoutez genericEmailsOnly=true pour ne recevoir que les adresses génériques. genericEmailsOnly=true masque aussi les emails des dirigeants.

curl https://api.ecommerce-leads-database.com/v1/stores/probikeshop.fr \
  -H "X-API-Key: eldb_live_…"

{
  "store": {
    "domain": "probikeshop.fr",
    "platform": "shopify",
    "tld": "fr",
    "country": "FR",
    "theme": "…",
    "productCount": 5000,
    "verificationStatus": "…",
    "lastSuccessAt": "…",
    "detectedApps": ["…"],
    "trackingIds": { "gtm": ["GTM-ABC123"], "googleAds": ["AW-123456789"] },
    "operator": { "country": "FR", "source": "vat" },
    "isActiveShop": true,
    "legal": { "pageUrl": "…", "companyIds": { "siren": "…", "vat": "…" }, "legalForm": "SAS" },
    "metadata": {
      "merchantName": "…",
      "contactEmail": "…",
      "contactEmailType": "generic",
      "contactEmailWithheld": null,
      "telephone": "+33…",
      "phoneType": "fixed_line",
      "address": { … },
      "sources": {
        "contactEmail": { "url": "https://…/mentions-legales", "at": "2026-10-19T08:00:00.000Z" }
      },
      "socialLinks": { "instagram": "…" },
      "currency": "EUR",
      "lang": "fr"
    },
    "emails": [
      { "email": "contact@…", "type": "generic", "sourceUrl": "https://…/contact" }
    ],
    "decisionMakers": [
      {
        "firstName": "Marie", "lastName": "Durand", "role": "president",
        "source": "rne", "sourceUrl": "https://annuaire-entreprises.data.gouv.fr/entreprise/…",
        "since": "2019-03-01", "email": "marie.durand@…", "emailStatus": "valid"
      }
    ],
    "company": {
      "registry": "fr", "registryId": "…", "officialName": "…",
      "activityCode": "47.91B", "headcountBand": "10-19", "createdOn": "…",
      "category": "PME", "legalFormCode": "5710", "active": true,
      "hq": "…", "checkedAt": "…"
    },
    "gmb": {
      "placeId": "…", "category": "…", "rating": 4.5, "votes": 594,
      "address": "…", "phone": "…", "website": "…"
    }
  }
}

Catalogue produits

Renvoie les produits de la boutique, 5 000 au plus. Disponible pour une partie des boutiques Shopify et WooCommerce. Sinon, erreur 404 no_catalog, non facturée. Coûte 10 requêtes.

curl https://api.ecommerce-leads-database.com/v1/stores/probikeshop.fr/catalog \
  -H "X-API-Key: eldb_live_…"

{
  "domain": "probikeshop.fr",
  "catalog": [
    {
      "id": "…", "title": "…", "handle": "…", "vendor": "…",
      "productType": "…", "tags": ["…"],
      "price": …, "compareAtPrice": …, "currency": "EUR",
      "available": true, "imageUrl": "…", "imageCount": …, "variantCount": …,
      "createdAt": "…", "updatedAt": "…"
    }
  ]
}

Tendance de trafic

Renvoie l'historique mensuel du trafic organique et des positions. Erreur 404 no_trend s'il n'y a pas de données, non facturée. Coûte 2 requêtes.

curl https://api.ecommerce-leads-database.com/v1/stores/probikeshop.fr/trend \
  -H "X-API-Key: eldb_live_…"

{
  "domain": "probikeshop.fr",
  "trend": [
    { "date": "2026-07-01", "organicTraffic": 197021, "organicPositions": 19377 }
  ],
  "savedAt": "2026-07-01T04:12:08.441Z"
}

Vos fournisseurs

Liste les fournisseurs dont la clé est enregistrée, avec leur statut et les crédits restants quand le fournisseur les donne. Gratuit.

curl https://api.ecommerce-leads-database.com/v1/enrichment/providers \
  -H "X-API-Key: eldb_live_…"

{
  "providers": [
    { "provider": "dropcontact", "status": "valid", "creditsRemaining": 250 }
  ]
}

Lancer un enrichissement

Envoyez provider et domain (une boutique) ou domains (25 au plus). maxPeoplePerStore : de 1 à 3, 2 par défaut. phones : true pour demander aussi les téléphones (plus de crédits). force : true pour relancer une personne enrichie il y a moins de 30 jours. Coûte 1 requête et 1 boutique par boutique qui a des dirigeants. Réponse 200 avec les résultats quand le fournisseur répond tout de suite, sinon 202 : suivez le job.

curl -X POST https://api.ecommerce-leads-database.com/v1/enrichments \
  -H "X-API-Key: eldb_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "provider": "dropcontact", "domains": ["probikeshop.fr"], "maxPeoplePerStore": 2 }'

HTTP/1.1 202 Accepted
{
  "job": {
    "id": "…", "provider": "dropcontact", "status": "queued", "phones": false,
    "storeCount": 1, "personCount": 2, "creditsUsed": null, "errorCode": null,
    "createdAt": "…", "updatedAt": "…"
  },
  "results": [
    { "domain": "probikeshop.fr", "status": "ok", "people": [ … ] }
  ]
}

Suivre un enrichissement

Renvoie le statut du job (queued, submitted, done, partial, failed, canceled) et les résultats par boutique. Gratuit. Attendez au moins 20 secondes entre deux appels.

curl https://api.ecommerce-leads-database.com/v1/enrichments/<jobId> \
  -H "X-API-Key: eldb_live_…"

Résultats d'une boutique

Renvoie la plateforme, le nom du marchand, les dirigeants, vos fournisseurs et vos résultats. Coûte 1 requête et 1 boutique. DELETE sur la même URL efface vos résultats pour cette boutique.

curl https://api.ecommerce-leads-database.com/v1/stores/probikeshop.fr/enrichment \
  -H "X-API-Key: eldb_live_…"

{
  "domain": "probikeshop.fr",
  "platform": "…",
  "merchantName": "…",
  "providers": ["dropcontact"],
  "decisionMakers": [{ "firstName": "…", "lastName": "…", "role": "president" }],
  "results": [
    {
      "firstName": "…", "lastName": "…", "role": "president", "provider": "dropcontact",
      "status": "found", "skipReason": null,
      "email": "…", "emailStatus": "valid", "emailStatusRaw": "nominative@pro", "emailKind": "professional",
      "phone": null, "phoneType": null, "linkedinUrl": "…", "jobTitle": "…",
      "creditsUsed": 1, "errorCode": null, "enrichedAt": "…", "reused": false
    }
  ]
}