API documentation

Free sample (no key)

Returns a few stores: 10 by default, 20 at most. Use it to see the data shape before subscribing. Does not count against any quota.

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

Your plan and quota

Returns your plan, requests and stores used, your databases and the reset date. Free: uses no request and no store.

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": "…"
}

Count stores

Returns how many stores match the filters, and how many have a Google profile. Costs 1 request and 0 stores.

Parameters: 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 }

Real figures for verified Shopify stores.

Search stores

Filters the database and returns one page of results (items) with a cursor (nextCursor).

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

• limit: 1 to 100 results per page. 50 by default.
• Order: highest traffic first. Stores with no known traffic come last.
• By default, search and count return verified stores only: a real online shop, re-checked on its own site. Add includeUnverified=true to also include brochure sites and unreachable sites.
• activeOnly is true by default: stores scored inactive are left out. Add activeOnly=false to include them.
• Filters: hasEmail (email collected in the last 12 months), hasPhone, app (a detected app, e.g. Klaviyo), currency (EUR), lang (fr), operatorCountry (FR), genericEmailsOnly (with hasEmail: generic mailboxes only). A bad value returns 400 invalid_parameter and the request is not charged.
• maxChromeRank (highest Chrome UX Report ranking bucket: 1000, 5000, 10000, 50000, 100000, 500000, 1000000, 5000000, 10000000 or 50000000). Any other value returns 400 invalid_parameter. The audience field contains Chrome UX Report (Google) data, under the CC BY-SA 4.0 license.
• mailProvider (email provider worked out from the MX: google-workspace, microsoft-365, ovh, infomaniak, ionos, gandi, zoho, proton, o2switch, hostinger, other, none) and dmarcPolicy (none, quarantine, reject or missing). Any other value returns 400 invalid_parameter. The app filter also finds tools read from DNS (for example Klaviyo through SPF). App slugs that DNS can add: 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.
• Public tracking IDs: use trackingId to find the other stores that share one code. Pass a bare value such as GTM-ABC123, AW-123456789, G-ABCDEF1234, UA-1234567-1 or ca-pub-1234567890123456. Numeric IDs need their type first: meta:123456789012345, tiktok:…, pinterest:…, microsoftAds:…, linkedin:…, hotjar:…, criteo:…, snapchat:…, clarity:…, klaviyo:… (Klaviyo is case-sensitive). Any other value returns 400 invalid_parameter. Each result also holds trackingIds (null until the store has been read).
• hasDecisionMaker=true|false (at least one known decision maker, or none) and hasDecisionMakerEmail=true (at least one decision maker whose email was found on the site or accepted by the mail server). Any other value returns 400 invalid_parameter. Each result also holds hasDecisionMaker.
• Next page: send the nextCursor value back in the cursor parameter. On the last page, nextCursor is null.
• Every store returned counts against your store budget. A page of 50 results uses 50 stores.
• Each result is a store summary: domain, platform, country, theme, product count, apps, traffic, merchant name, Google rating and category, hasEmail, hasPhone, hasDecisionMaker, currency, lang, operatorCountry, isActiveShop. Each result also holds audience (null when the store is not in the Chrome UX Report ranking). Each result also holds dns (null until the store has been read). For the full record, call /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…"
}

Store record

Returns the full record of one store. Costs 1 request and 1 store. The catalog is not included: use /catalog. Every email is returned with its type; add genericEmailsOnly=true to receive generic mailboxes only. genericEmailsOnly=true also hides decision-maker emails.

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": "…"
    }
  }
}

Product catalog

Returns the store's products, up to 5,000. Available for part of the Shopify and WooCommerce stores. Otherwise you get a 404 no_catalog, which is not billed. Costs 10 requests.

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": "…"
    }
  ]
}

Traffic trend

Returns the monthly history of organic traffic and positions. 404 no_trend when there is no data, not billed. Costs 2 requests.

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"
}

Your providers

Lists the providers with a saved key, with their status and the credits left when the provider reports them. Free.

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

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

Start an enrichment

Send provider and domain (one store) or domains (25 at most). maxPeoplePerStore: 1 to 3, 2 by default. phones: true to ask for phone numbers too (more credits). force: true to run again a person enriched less than 30 days ago. Costs 1 request and 1 store per store with decision makers. Answers 200 with the results when the provider answers at once, otherwise 202: follow the 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": [ … ] }
  ]
}

Follow an enrichment

Returns the job status (queued, submitted, done, partial, failed, canceled) and the results by store. Free. Wait at least 20 seconds between two calls.

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

A store's results

Returns the platform, the merchant name, the decision makers, your providers and your results. Costs 1 request and 1 store. DELETE on the same URL erases your results for this store.

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
    }
  ]
}