Documentazione dell'API

Campione gratuito (senza chiave)

Restituisce alcuni negozi: 10 di default, al massimo 20. Serve a vedere la forma dei dati prima di abbonarsi. Non conta nella quota.

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

Il Suo piano e la Sua quota

Restituisce il Suo piano, le richieste e i negozi usati, i Suoi database e la data di azzeramento. Gratuito: non consuma né richieste né negozi.

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

Contare i negozi

Restituisce il numero di negozi che corrispondono ai filtri e quanti hanno una scheda Google. Costa 1 richiesta e 0 negozi.

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

Numeri reali per i negozi Shopify verificati.

Cercare negozi

Filtra il database e restituisce una pagina di risultati (items) con un cursore (nextCursor).

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

• limit: da 1 a 100 risultati per pagina. 50 di default.
• Ordinamento: dal traffico più alto al più basso. I negozi senza traffico noto compaiono per ultimi.
• Di default, search e count restituiscono solo i negozi verificati: veri negozi online, ricontrollati sul loro sito. Aggiunga includeUnverified=true per includere anche i siti vetrina e i siti irraggiungibili.
• activeOnly è true per impostazione predefinita: i negozi valutati inattivi sono esclusi. Aggiungi activeOnly=false per includerli.
• Filtri: hasEmail (email raccolta negli ultimi 12 mesi), hasPhone, app (un'app rilevata, es. Klaviyo), currency (EUR), lang (fr), operatorCountry (FR), genericEmailsOnly (con hasEmail: solo caselle generiche). Un valore non valido restituisce 400 invalid_parameter e la richiesta non viene addebitata.
• maxChromeRank (fascia massima della classifica del Chrome UX Report: 1000, 5000, 10000, 50000, 100000, 500000, 1000000, 5000000, 10000000 o 50000000). Qualsiasi altro valore restituisce 400 invalid_parameter. Il campo audience contiene dati del Chrome UX Report (Google), con licenza CC BY-SA 4.0.
• mailProvider (fornitore di posta ricavato dall'MX: google-workspace, microsoft-365, ovh, infomaniak, ionos, gandi, zoho, proton, o2switch, hostinger, other, none) e dmarcPolicy (none, quarantine, reject o missing). Qualsiasi altro valore restituisce 400 invalid_parameter. Il filtro app trova anche gli strumenti letti nel DNS (per esempio Klaviyo tramite SPF). Slug delle app che il DNS può aggiungere: 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.
• Codici di tracciamento pubblici: usi trackingId per trovare gli altri negozi che condividono lo stesso codice. Passi un valore singolo come GTM-ABC123, AW-123456789, G-ABCDEF1234, UA-1234567-1 o ca-pub-1234567890123456. I codici numerici vogliono il tipo davanti: meta:123456789012345, tiktok:…, pinterest:…, microsoftAds:…, linkedin:…, hotjar:…, criteo:…, snapchat:…, clarity:…, klaviyo:… (Klaviyo distingue maiuscole e minuscole). Ogni altro valore restituisce 400 invalid_parameter. Ogni risultato contiene anche trackingIds (null finché il negozio non è stato letto).
• hasDecisionMaker=true|false (almeno un dirigente noto, o nessuno) e hasDecisionMakerEmail=true (almeno un dirigente la cui email è stata trovata sul sito o accettata dal server di posta). Qualsiasi altro valore restituisce 400 invalid_parameter. Ogni risultato include anche hasDecisionMaker.
• Pagina successiva: passi il valore di nextCursor nel parametro cursor. All'ultima pagina, nextCursor vale null.
• Ogni negozio restituito conta nel Suo budget negozi. Una pagina di 50 risultati consuma 50 negozi.
• Ogni risultato è un riepilogo del negozio: dominio, piattaforma, paese, tema, numero di prodotti, app, traffico, nome del commerciante, voto e categoria Google, hasEmail, hasPhone, hasDecisionMaker, currency, lang, operatorCountry, isActiveShop. Ogni risultato include anche audience (null se il negozio non è in classifica nel Chrome UX Report). Ogni risultato include anche dns (null finché il negozio non è stato letto). Per la scheda completa, chiama /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…"
}

Scheda di un negozio

Restituisce la scheda completa di un negozio. Costa 1 richiesta e 1 negozio. Il catalogo non è incluso: usa /catalog. Ogni email è restituita con il suo tipo; aggiungi genericEmailsOnly=true per ricevere solo caselle generiche. genericEmailsOnly=true nasconde anche le email dei dirigenti.

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

Catalogo prodotti

Restituisce i prodotti del negozio, al massimo 5.000. Disponibile per una parte dei negozi Shopify e WooCommerce. Altrimenti, errore 404 no_catalog, non addebitato. Costa 10 richieste.

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

Andamento del traffico

Restituisce lo storico mensile del traffico organico e dei posizionamenti. Errore 404 no_trend se non ci sono dati, non addebitato. Costa 2 richieste.

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

I Suoi fornitori

Elenca i fornitori con una chiave salvata, con lo stato e i crediti rimasti quando il fornitore li comunica. Gratis.

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

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

Avviare un arricchimento

Invii provider e domain (un negozio) o domains (25 al massimo). maxPeoplePerStore: da 1 a 3, 2 di default. phones: true per chiedere anche i telefoni (più crediti). force: true per rilanciare una persona arricchita meno di 30 giorni fa. Costa 1 richiesta e 1 negozio per ogni negozio con dirigenti. Risponde 200 con i risultati quando il fornitore risponde subito, altrimenti 202: segua il 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": [ … ] }
  ]
}

Seguire un arricchimento

Restituisce lo stato del job (queued, submitted, done, partial, failed, canceled) e i risultati per negozio. Gratis. Aspetti almeno 20 secondi tra due chiamate.

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

Risultati di un negozio

Restituisce la piattaforma, il nome del commerciante, i dirigenti, i Suoi fornitori e i Suoi risultati. Costa 1 richiesta e 1 negozio. DELETE sullo stesso URL cancella i Suoi risultati per questo negozio.

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