Documentación de la API

Muestra gratuita (sin clave)

Devuelve algunas tiendas: 10 por defecto, 20 como máximo. Sirve para ver el formato de los datos antes de suscribirse. No cuenta en la cuota.

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

Su plan y su cuota

Devuelve su plan, las peticiones y tiendas consumidas, sus bases y la fecha de reinicio. Gratis: no consume ninguna petición ni ninguna tienda.

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

Contar tiendas

Devuelve el número de tiendas que cumplen los filtros y cuántas tienen perfil de Google. Cuesta 1 petición y 0 tiendas.

Parámetros: 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 }

Cifras reales de las tiendas Shopify verificadas.

Buscar tiendas

Filtra la base y devuelve una página de resultados (items) con un cursor (nextCursor).

Parámetros: 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 a 100 resultados por página. 50 por defecto.
• Orden: de mayor a menor tráfico. Las tiendas sin tráfico conocido aparecen al final.
• Por defecto, search y count solo devuelven tiendas verificadas: una tienda online real, comprobada de nuevo en su propio sitio. Añada includeUnverified=true para incluir también los sitios corporativos y los sitios inaccesibles.
• activeOnly es true por defecto: se excluyen las tiendas evaluadas como inactivas. Añada activeOnly=false para incluirlas.
• Filtros: hasEmail (email recogido en los últimos 12 meses), hasPhone, app (una app detectada, p. ej. Klaviyo), currency (EUR), lang (fr), operatorCountry (FR), genericEmailsOnly (con hasEmail: solo buzones genéricos). Un valor inválido devuelve 400 invalid_parameter y la petición no se cobra.
• maxChromeRank (tramo máximo del ranking del Chrome UX Report: 1000, 5000, 10000, 50000, 100000, 500000, 1000000, 5000000, 10000000 o 50000000). Cualquier otro valor devuelve 400 invalid_parameter. El campo audience contiene datos del Chrome UX Report (Google), con licencia CC BY-SA 4.0.
• mailProvider (proveedor de correo deducido del MX: google-workspace, microsoft-365, ovh, infomaniak, ionos, gandi, zoho, proton, o2switch, hostinger, other, none) y dmarcPolicy (none, quarantine, reject o missing). Cualquier otro valor devuelve 400 invalid_parameter. El filtro app también encuentra las herramientas leídas en el DNS (por ejemplo Klaviyo a través de SPF). Slugs de apps que el DNS puede añadir: 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.
• Códigos de seguimiento públicos: use trackingId para encontrar las otras tiendas que comparten un mismo código. Pase un valor suelto como GTM-ABC123, AW-123456789, G-ABCDEF1234, UA-1234567-1 o ca-pub-1234567890123456. Los códigos numéricos necesitan su tipo delante: meta:123456789012345, tiktok:…, pinterest:…, microsoftAds:…, linkedin:…, hotjar:…, criteo:…, snapchat:…, clarity:…, klaviyo:… (Klaviyo distingue mayúsculas y minúsculas). Cualquier otro valor devuelve 400 invalid_parameter. Cada resultado incluye también trackingIds (null hasta que se lee la tienda).
• hasDecisionMaker=true|false (al menos un directivo conocido, o ninguno) y hasDecisionMakerEmail=true (al menos un directivo cuyo email se encontró en el sitio o fue aceptado por el servidor de correo). Cualquier otro valor devuelve 400 invalid_parameter. Cada resultado incluye también hasDecisionMaker.
• Página siguiente: envíe el valor de nextCursor en el parámetro cursor. En la última página, nextCursor vale null.
• Cada tienda devuelta cuenta en su presupuesto de tiendas. Una página de 50 resultados consume 50 tiendas.
• Cada resultado es un resumen de tienda: dominio, plataforma, país, tema, número de productos, apps, tráfico, nombre del comerciante, nota y categoría de Google, hasEmail, hasPhone, hasDecisionMaker, currency, lang, operatorCountry, isActiveShop. Cada resultado incluye también audience (null si la tienda no está en el ranking del Chrome UX Report). Cada resultado incluye también dns (null hasta que se lea la tienda). Para la ficha completa, llame a /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…"
}

Ficha de una tienda

Devuelve la ficha completa de una tienda. Cuesta 1 petición y 1 tienda. El catálogo no se incluye: use /catalog. Cada email se devuelve con su tipo; añada genericEmailsOnly=true para recibir solo buzones genéricos. genericEmailsOnly=true oculta también los emails de los directivos.

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

Catálogo de productos

Devuelve los productos de la tienda, 5.000 como máximo. Disponible para una parte de las tiendas Shopify y WooCommerce. Si no, error 404 no_catalog, sin coste. Cuesta 10 peticiones.

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

Tendencia de tráfico

Devuelve el historial mensual del tráfico orgánico y de las posiciones. Error 404 no_trend si no hay datos, sin coste. Cuesta 2 peticiones.

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

Sus proveedores

Lista los proveedores con una clave guardada, con su estado y los créditos restantes cuando el proveedor los da. Gratis.

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

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

Lanzar un enriquecimiento

Envíe provider y domain (una tienda) o domains (25 como máximo). maxPeoplePerStore: de 1 a 3, 2 por defecto. phones: true para pedir también los teléfonos (más créditos). force: true para volver a enriquecer a una persona enriquecida hace menos de 30 días. Cuesta 1 petición y 1 tienda por cada tienda con directivos. Responde 200 con los resultados cuando el proveedor responde enseguida, si no 202: siga el 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": [ … ] }
  ]
}

Seguir un enriquecimiento

Devuelve el estado del job (queued, submitted, done, partial, failed, canceled) y los resultados por tienda. Gratis. Espere al menos 20 segundos entre dos llamadas.

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

Resultados de una tienda

Devuelve la plataforma, el nombre del comercio, los directivos, sus proveedores y sus resultados. Cuesta 1 petición y 1 tienda. DELETE en la misma URL borra sus resultados de esta tienda.

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