Documentation API

Endpoints REST. JSON en entrée, JSON en sortie. Auth via header X-API-Key.

Authentification

Chaque endpoint payant nécessite un header X-API-Key. Récupérez votre clé depuis votre page Compte après abonnement.

curl https://api.ecommerce-leads-database.com/v1/stores/count \
  -H "X-API-Key: sk_live_…"

Endpoints

GET/v1/sample

Échantillon gratuit (sans auth)

Renvoie 10 boutiques enrichies. Pour valider la forme des données avant abonnement.

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

Comptage agrégé

Renvoie le nombre de boutiques matchant les filtres, plus combien ont une fiche Google.

curl https://api.ecommerce-leads-database.com/v1/stores/count?platform=shopify \
  -H "X-API-Key: sk_live_…"

{ "count": 124538, "gmbCount": 38217 }
GET/v1/stores/search

Recherche de boutiques

Filtré + paginé. Supporte platform, tld, country, minProducts, hasGmb. 100 résultats max par page.

curl https://api.ecommerce-leads-database.com/v1/stores/search \
  -H "X-API-Key: sk_live_…" \
  -G \
  -d "platform=shopify" \
  -d "minProducts=50" \
  -d "hasGmb=true" \
  -d "limit=50"

{
  "items": [ { "domain": "…", "merchantName": "…", … } ],
  "nextCursor": "…"
}
GET/v1/stores/:domain

Détail boutique

Ligne complète avec métadonnées parsées et données GMB. N'inclut pas le catalogue produits.

curl https://api.ecommerce-leads-database.com/v1/stores/eataly.fr \
  -H "X-API-Key: sk_live_…"

{ "store": { "domain": "eataly.fr", "platform": "shopify", "metadata": {…}, "gmbData": {…} } }
GET/v1/stores/:domain/catalog

Dump catalogue produits

Liste complète des produits de la boutique, depuis le stockage R2. Compte pour 10 requêtes.

curl https://api.ecommerce-leads-database.com/v1/stores/eataly.fr/catalog \
  -H "X-API-Key: sk_live_…"

MCP

Connect your AI agent (Claude, Cursor, ChatGPT, n8n…) to the database — 7 tools, same API key, same quotas.

claude mcp add eldb --transport http https://mcp.ecommerce-leads-database.com/mcp \
  --header "X-API-Key: sk_live_…"

Limites de débit

Quotas mensuels, fenêtre roulante de 30 jours. Pas de rate-limit par seconde.

Erreurs