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 d'acheter des crédits. Gratuit.

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

Votre solde de crédits

Renvoie votre solde, les crédits qui expirent en premier, un ancien plan encore actif (legacyPlan, sinon null) et la grille de prix (pricing). Gratuit.

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

{
  "credits": {
    "balance": 18450,
    "nextExpiry": { "credits": 18450, "at": "2027-10-24T09:12:00.000Z" }
  },
  "legacyPlan": null,
  "pricing": {
    "creditPerStoreRow": 1,
    "unlockedStoresStayFree": true,
    "free": ["/v1/stores/count", "/v1/me", "/v1/enrichments/:jobId"],
    "managedEnrichment": { "perWorkEmailFound": 6, "perMobileFound": 60 },
    "packs": [
      { "id": "credits_1k", "credits": 1000, "priceEurExclVat": 29 },
      { "id": "credits_5k", "credits": 5000, "priceEurExclVat": 99 },
      { "id": "credits_20k", "credits": 20000, "priceEurExclVat": 299 },
      { "id": "credits_100k", "credits": 100000, "priceEurExclVat": 990 }
    ]
  }
}

Compter les boutiques

Renvoie le nombre de boutiques qui correspondent aux filtres, et combien ont une fiche Google. Gratuit.

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

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, region, createdAfter, createdBefore, maxPlatformRank, plan, 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 ne coûte rien.
• 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.
• region filtre sur la région de la boutique : un code ISO 3166-2 ou une liste séparée par des virgules, par exemple region=FR-IDF,CH-VD. Codes : régions françaises (FR-IDF, FR-ARA…), provinces belges (BE-BRU, BE-VAN…), cantons suisses (CH-VD, CH-ZH…) et LI. createdAfter et createdBefore (YYYY-MM-DD) filtrent sur la date de création du domaine : createdAfter inclut le jour, createdBefore ne l'inclut pas. maxPlatformRank garde les N premières boutiques de chaque plateforme, par exemple platform=shopify&maxPlatformRank=1000. plan=shopify_plus garde les boutiques Shopify Plus confirmées : une app du site affiche la formule, ou le paiement montre des fonctions réservées à Plus. C'est la seule valeur : une boutique sans cette preuve peut quand même être sur Plus. Les boutiques sans valeur connue sont écartées. Une valeur invalide renvoie 400 invalid_parameter et ne coûte rien.
• Page suivante : renvoyez la valeur de nextCursor dans le paramètre cursor. À la dernière page, nextCursor vaut null.
• Chaque boutique renvoyée coûte 1 crédit, sauf si vous l'avez déjà débloquée. Une fiche débloquée le reste pour toujours. Une page de 50 nouvelles boutiques coûte 50 crédits. Si le solde ne suffit pas, la réponse est 402 et rien n'est envoyé : baissez limit.
• 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, region, domainCreatedOn, domainCreatedSource, domainCreatedEstimated, platformRank, linkedinUrl, plan. 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…"
}

Exporter des boutiques (CSV)

Les mêmes filtres que la recherche, dans un fichier CSV à ouvrir dans un tableur. Une ligne par boutique, après une ligne d'en-tête.

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

• limit : de 1 à 5 000 boutiques par fichier. 1 000 par défaut.
• Fichier suivant : l'en-tête de réponse X-Next-Cursor contient le curseur. Renvoyez-le dans le paramètre cursor. Au dernier fichier, l'en-tête est absent.
• Colonnes, dans cet ordre : domain, merchant_name, platform, plan, country_code, state, city, created, emails, telephone, linkedin_url, linkedin_account, facebook, instagram, pinterest, tiktok, twitter, estimated_monthly_sales, estimated_yearly_sales, platform_rank, product_count, crux_rank_class, status, first_seen, last_checked, decision_maker_emails, facebook_followers, instagram_followers, pinterest_followers, tiktok_followers. Les listes (emails, decision_maker_emails) sont séparées par deux-points. Les dates sont au format AAAA-MM-JJ. Les colonnes *_followers restent vides tant que le compte n'est pas compté : l'export demande les chiffres qui manquent, et ils figurent dans un export suivant.
• estimated_monthly_sales et estimated_yearly_sales sont vides pour le moment. Elles restent dans l'en-tête pour que le format du fichier ne change pas quand les données arriveront. plan vaut Shopify Plus quand nous l'avons confirmé. Une case vide veut dire inconnu, pas un autre plan.
• Pour Excel, ajoutez bom=1 : le fichier commence alors par un BOM UTF-8 et les accents s'affichent correctement.
• Les emails suivent les règles de /v1/stores/:domain : une adresse dont le titulaire s'est opposé n'est jamais envoyée, une adresse collectée il y a plus de 12 mois est retirée, et genericEmailsOnly=true ne garde que les boîtes génériques (et aucun email de dirigeant).
• Une cellule qui commence par =, +, - ou @ reçoit un ' devant, pour qu'un tableur ne la lise jamais comme une formule. Un numéro comme +33… s'affiche '+33….
• Chaque boutique du fichier coûte 1 crédit, sauf si vous l'avez déjà débloquée. Si le solde ne suffit pas, la réponse est 402 et aucun fichier n'est envoyé : baissez limit.

curl -G https://api.ecommerce-leads-database.com/v1/stores/export.csv \
  -H "X-API-Key: eldb_live_…" \
  -d country=FR \
  -d hasEmail=true \
  -d limit=5000 \
  -D headers.txt -o stores.csv

# headers.txt
X-Next-Cursor: 18450:01J…
X-Credits-Charged: 5000

# stores.csv
domain,merchant_name,platform,plan,country_code,state,city,created,emails,…
probikeshop.fr,Probikeshop,shopify,,FR,…

Fiche d'une boutique

Renvoie la fiche complète d'une boutique. Coûte 1 crédit, gratuit si vous l'avez déjà débloquée. 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,
    "region": { "code": "FR-…", "name": "…" },
    "domainCreatedOn": "…",
    "domainCreatedSource": "afnic",
    "domainCreatedEstimated": false,
    "platformRank": …,
    "linkedinUrl": "https://www.linkedin.com/company/…/",
    "plan": "shopify_plus",
    "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"
    },
    "socialFollowers": {
      "instagram": { "followers": 12400, "status": "ok", "checkedAt": "2026-11-04T09:00:00.000Z" }
    },
    "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 1 crédit, comme la fiche.

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 1 crédit, comme la fiche.

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. managedProviders liste les fournisseurs disponibles sur notre compte. Gratuit.

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

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

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. La réponse donne les noms et fonctions des dirigeants : chaque boutique qui en a coûte 1 crédit, gratuit si vous l'avez déjà débloquée. Avec votre clé, l'enrichissement lui-même est gratuit. 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. Un job géré renvoie aussi managed, eldbCreditsReserved et eldbCreditsCharged. 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 crédit, gratuit si vous l'avez déjà débloquée. 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
    }
  ]
}