API-Dokumentation

Kostenlose Stichprobe (ohne Schlüssel)

Liefert einige Shops: standardmäßig 10, höchstens 20. So sehen Sie das Datenformat, bevor Sie ein Abo abschließen. Zählt nicht zum Kontingent.

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

Ihr Plan und Ihr Kontingent

Liefert Ihren Plan, Ihre genutzten Anfragen und Shops, Ihre Datenbanken und das Datum der Zurücksetzung. Kostenlos: verbraucht weder Anfragen noch Shops.

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

Shops zählen

Liefert die Zahl der Shops, die zu den Filtern passen, und wie viele davon einen Google-Eintrag haben. Kostet 1 Anfrage und 0 Shops.

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

Echte Zahlen für geprüfte Shopify-Shops.

Shops suchen

Filtert die Datenbank und liefert eine Ergebnisseite (items) mit einem Cursor (nextCursor).

Parameter: 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 bis 100 Ergebnisse pro Seite. Standard: 50.
• Sortierung: vom höchsten zum niedrigsten Traffic. Shops ohne bekannten Traffic kommen zuletzt.
• Standardmäßig liefern search und count nur geprüfte Shops: echte Onlineshops, auf ihrer Website erneut geprüft. Mit includeUnverified=true erhalten Sie auch reine Unternehmensseiten und nicht erreichbare Websites.
• activeOnly ist standardmäßig true: als inaktiv bewertete Shops werden ausgelassen. Mit activeOnly=false werden sie einbezogen.
• Filter: hasEmail (E-Mail in den letzten 12 Monaten erfasst), hasPhone, app (erkannte App, z. B. Klaviyo), currency (EUR), lang (fr), operatorCountry (FR), genericEmailsOnly (mit hasEmail: nur allgemeine Postfächer). Ein ungültiger Wert ergibt 400 invalid_parameter, die Anfrage wird nicht berechnet.
• maxChromeRank (höchste Ranking-Stufe des Chrome UX Report: 1000, 5000, 10000, 50000, 100000, 500000, 1000000, 5000000, 10000000 oder 50000000). Jeder andere Wert liefert 400 invalid_parameter. Das Feld audience enthält Daten des Chrome UX Report (Google) unter der Lizenz CC BY-SA 4.0.
• mailProvider (aus dem MX abgeleiteter E-Mail-Anbieter: google-workspace, microsoft-365, ovh, infomaniak, ionos, gandi, zoho, proton, o2switch, hostinger, other, none) und dmarcPolicy (none, quarantine, reject oder missing). Jeder andere Wert liefert 400 invalid_parameter. Der Filter app findet auch Tools, die im DNS gelesen wurden (zum Beispiel Klaviyo über SPF). App-Slugs, die das DNS hinzufügen kann: 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.
• Öffentliche Tracking-IDs: Mit trackingId finden Sie die anderen Shops, die denselben Code teilen. Übergeben Sie einen einzelnen Wert wie GTM-ABC123, AW-123456789, G-ABCDEF1234, UA-1234567-1 oder ca-pub-1234567890123456. Numerische IDs brauchen ihren Typ davor: meta:123456789012345, tiktok:…, pinterest:…, microsoftAds:…, linkedin:…, hotjar:…, criteo:…, snapchat:…, clarity:…, klaviyo:… (bei Klaviyo zählt die Groß- und Kleinschreibung). Jeder andere Wert liefert 400 invalid_parameter. Jedes Ergebnis enthält auch trackingIds (null, bis der Shop gelesen wurde).
• hasDecisionMaker=true|false (mindestens ein bekannter Entscheider oder keiner) und hasDecisionMakerEmail=true (mindestens ein Entscheider, dessen E-Mail auf der Website gefunden oder vom Mailserver angenommen wurde). Jeder andere Wert liefert 400 invalid_parameter. Jedes Ergebnis enthält außerdem hasDecisionMaker.
• Nächste Seite: Senden Sie den Wert von nextCursor im Parameter cursor zurück. Auf der letzten Seite ist nextCursor null.
• Jeder gelieferte Shop zählt zu Ihrem Shop-Budget. Eine Seite mit 50 Ergebnissen verbraucht 50 Shops.
• Jedes Ergebnis ist eine Shop-Zusammenfassung: Domain, Plattform, Land, Theme, Produktanzahl, Apps, Traffic, Händlername, Google-Bewertung und -Kategorie, hasEmail, hasPhone, hasDecisionMaker, currency, lang, operatorCountry, isActiveShop. Jedes Ergebnis enthält außerdem audience (null, wenn der Shop nicht im Ranking des Chrome UX Report steht). Jedes Ergebnis enthält außerdem dns (null, bis der Shop gelesen wurde). Für den vollständigen Datensatz /v1/stores/:domain aufrufen.

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

Eintrag eines Shops

Liefert den vollständigen Datensatz eines Shops. Kostet 1 Anfrage und 1 Shop. Der Katalog ist nicht enthalten: /catalog verwenden. Jede E-Mail kommt mit ihrem Typ; mit genericEmailsOnly=true nur allgemeine Postfächer. genericEmailsOnly=true blendet auch die E-Mails der Entscheider aus.

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

Produktkatalog

Liefert die Produkte des Shops, höchstens 5.000. Verfügbar für einen Teil der Shopify- und WooCommerce-Shops. Sonst Fehler 404 no_catalog, nicht berechnet. Kostet 10 Anfragen.

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

Liefert den monatlichen Verlauf von organischem Traffic und Rankings. Fehler 404 no_trend, wenn keine Daten vorliegen, nicht berechnet. Kostet 2 Anfragen.

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

Ihre Anbieter

Listet die Anbieter mit gespeichertem Schlüssel, mit Status und verbleibenden Credits, wenn der Anbieter sie mitteilt. Kostenlos.

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

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

Eine Anreicherung starten

Senden Sie provider und domain (ein Shop) oder domains (höchstens 25). maxPeoplePerStore: 1 bis 3, Standard 2. phones: true, um auch Telefonnummern anzufragen (mehr Credits). force: true, um eine Person erneut anzureichern, die vor weniger als 30 Tagen angereichert wurde. Kostet 1 Anfrage und 1 Shop pro Shop mit Entscheidern. Antwort 200 mit den Ergebnissen, wenn der Anbieter sofort antwortet, sonst 202: Verfolgen Sie den 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": [ … ] }
  ]
}

Eine Anreicherung verfolgen

Liefert den Status des Jobs (queued, submitted, done, partial, failed, canceled) und die Ergebnisse pro Shop. Kostenlos. Warten Sie mindestens 20 Sekunden zwischen zwei Aufrufen.

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

Ergebnisse eines Shops

Liefert die Plattform, den Händlernamen, die Entscheider, Ihre Anbieter und Ihre Ergebnisse. Kostet 1 Anfrage und 1 Shop. DELETE auf derselben URL löscht Ihre Ergebnisse für diesen Shop.

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