Pour un développeur d'outil B2B Shopify

Le besoin en 30 secondes

Vous travaillez sur un produit qui touche l’écosystème Shopify : outil d’enrichissement CRM, plateforme de prospection automatisée, outil d’analyse retail, application place de marché B2B. À un moment, vous avez besoin de la liste des marchands Shopify, idéalement filtrée par stack technique (Klaviyo, Judge.me, Recharge, Shopify Plus).

Sauf que cette donnée n’existe pas en API officielle. Shopify n’expose pas d’« annuaire des marchands ». BuiltWith vend la technologie mais pas la base structurée. Wappalyzer pareil. Du coup, vous codez votre propre outil d’exploration. Première semaine ça tourne. Troisième semaine, Cloudflare commence à bloquer vos IP résidentielles. Sixième semaine, Shopify change un fragment de DOM sur le checkout et votre détecteur Klaviyo casse en silence pendant 4 jours avant que quelqu’un s’en aperçoive.

Le résultat : 5 heures par semaine à corriger un flux de données qui n’est même pas votre cœur de produit.

Ce qui se passe sans accès propre

Le scénario typique. Vous démarrez avec un script Python rapide qui interroge /products.json sur une liste de domaines Shopify connus. Ça marche : /products.json est public, c’est même la signature canonique pour identifier un site Shopify (voir le guide reconnaître un site Shopify).

Puis vous voulez la stack secondaire. Klaviyo se détecte au regex sur le HTML rendu. Judge.me se voit dans les <script src>. Shopify Plus, lui, ne se voit plus sur la page d’accueil : Shopify a retiré ces marqueurs en 2024. Il faut une appli intégrée aux étapes du paiement, une appli qui affiche le plan dans le code de la page, ou Multipass. Vous écrivez un détecteur par technologie, vous lancez en planificateur toutes les 24 heures sur 50 000 domaines.

Puis arrivent les vrais problèmes :

• Les marchands sous Hydrogen ou avec une vitrine découplée (headless) ne renvoient pas le HTML attendu. Faux négatifs en cascade.
• Cloudflare anti-robots vous bloque après 10 000 requêtes en 1 heure. Vous louez des IP résidentielles, facturées au Go. Le coût grimpe.
• Shopify renomme une classe CSS dans un thème. Votre détecteur passe en faux positif sur 2 000 boutiques pendant une semaine.
• Votre développeur junior passe 3 jours à remonter pourquoi Klaviyo a chuté de 40 % en données alors qu’aucun marchand n’a vraiment migré.

C’est de la dette technique pure. L’outil d’exploration Shopify maison n’est pas un avantage concurrentiel pour votre produit, c’est une distraction.

Le flux avec l’API

L’idée est simple : l’exploration tourne de notre côté. Vous consommez le résultat propre. Les comptes, les crédits et l’API sont servis par Ecommerce Leads Database ; la clé se passe dans l’en-tête X-API-Key (ou Authorization: Bearer).

Étape 1 : récupération initiale en lot avec filtres. Vous appelez /v1/stores/search avec les filtres pertinents pour votre cas : pays, région, extension, appli détectée, devise, langue, date de création du domaine, rang dans la plateforme, audience Chrome, nombre minimal de produits, Shopify Plus confirmé, avec email, téléphone ou dirigeant. Pagination par curseur, jusqu’à 100 résultats par page. Chaque boutique renvoyée coûte 1 crédit, sauf si vous l’avez déjà débloquée.

curl -H "X-API-Key: $CLE" \
  "https://api.ecommerce-leads-database.com/v1/stores/search?platform=shopify&country=FR&tld=fr&app=klaviyo&limit=100"

Réponse JSON (extrait) :

{
  "items": [
    {
      "domain": "exemple-marchand.fr",
      "platform": "shopify",
      "tld": "fr",
      "country": "FR",
      "theme": "Dawn",
      "productCount": 214,
      "merchantName": "Exemple Marchand",
      "hasEmail": true,
      "hasPhone": true,
      "hasDecisionMaker": false
    }
  ],
  "nextCursor": "..."
}

Les applis détectées sont en base : 64 % des boutiques Shopify européennes ont au moins une appli détectée, et 22 % ont Klaviyo. Le filtre app les cible directement. Pour Shopify Plus, le filtre plan=shopify_plus ne garde que les boutiques confirmées. Chaque résultat et la fiche complète (GET /v1/stores/{domaine}) portent un champ plan : "shopify_plus" ou null. Un null veut dire « inconnu », jamais « pas Plus ».

Étape 2 : suivi des nouveaux marchands. Pas de notification poussée vers votre serveur : votre planificateur interroge l’API à son rythme. Le comptage est gratuit : appelez-le chaque jour avec vos filtres, et relancez la recherche quand le nombre bouge. Relancer une recherche entière ne coûte que les boutiques nouvelles, les autres sont déjà débloquées. Le filtre createdAfter (date de création du domaine) isole les boutiques récentes.

curl -H "X-API-Key: $CLE" \
  "https://api.ecommerce-leads-database.com/v1/stores/count?platform=shopify&country=FR&createdAfter=2026-09-01"

Votre solde se lit gratuitement sur GET /v1/me.

Étape 3 : intégration dans votre stack. Vous écrivez le résultat dans Postgres / Mongo / BigQuery. Pattern classique : table shopify_merchants indexée sur le domaine et la date de dernière vérification. Si vous travaillez en n8n, Make ou Zapier, c’est un flux de 5 étapes : planificateur → requête HTTP vers l’API → filtre → mise à jour base de données → notification Slack.

Étape 4 : déclencher des actions en aval. Une fois la fiche en base, vous déclenchez ce qui colle à votre produit : synchronisation vers Lemlist pour prospection, ajout dans HubSpot pour enrichir un compte existant, création d’une ligne Customer.io pour scoring de prospects, ou simple notification Slack pour un opérateur humain.

Et pour vos agents IA : le serveur MCP. Si votre produit ou votre équipe s’appuie sur un agent (Claude, Cursor…), branchez https://mcp.ecommerce-leads-database.com/mcp : même clé, mêmes crédits, 8 outils (recherche, comptage, fiche, catalogue, historique du trafic, solde…).

Ce que vous payez : des crédits, pas un abonnement

Un seul accès, l’API et le serveur MCP, payé en packs de crédits. Le pack se choisit au volume.

Ce que les crédits donnent :

• 1 crédit = 1 boutique renvoyée, dirigeants inclus. Une boutique débloquée le reste pour toujours : la redemander (fiche, recherche, export, catalogue, historique du trafic) ne coûte rien.
• Gratuit : le comptage (/v1/stores/count), le solde (/v1/me) et l’échantillon (/v1/sample, sans clé).
• Pas de quota mensuel d’appels, pas de licence par utilisateur, pas d’abonnement : seulement des crédits.
• Crédits valables 12 mois, en paiement unique.
• Les 32 pays européens de la base avec la même clé.
• Le serveur MCP avec la même clé et les mêmes crédits.

Si votre outil sert lui-même de gros volumes à ses clients, le pack de 100 000 crédits (990 € HT) met la boutique à moins d’un centime. Pour un usage qui dépasse les packs, écrivez à hello@ecommerce-leads-database.com.

Combien ça coûte vraiment face à un outil maison

Faisons le calcul honnête.

Outil maison sérieux, par mois :

• Développeur junior, 3 j/mois sur maintenance (déboguer, corriger les regex, surveiller) à 350 € HT/jour = 1 050 €
• IP résidentielles tournantes (volume modeste, environ 50 Go/mois à 3 à 6 € le Go) = 150 à 300 €
• Serveur d’exploration (workers Python + file d’attente) = 40 à 80 €
• Stockage et journaux = 20 €
• Bug en production qui casse 1 fonctionnalité produit pendant 4 jours, 1 fois par trimestre = coût caché variable

Total visible mensuel : 1 260 à 1 450 €, sans compter la dette technique et le coût d’opportunité (votre développeur junior pourrait coder votre vraie fonctionnalité à la place).

Avec les crédits : toute la France (38 000 boutiques Shopify vérifiées) coûte 598 € HT, une seule fois, en 2 packs de 20 000 crédits. Redemander ensuite ces boutiques est gratuit : seules les nouvelles consomment des crédits.

Le seuil de rentabilité est trivial : 598 € HT une fois, c’est moins que la moitié d’un seul mois d’outil maison (1 260 € au minimum).

Précisions techniques

Transparence d’abord, on ne vend pas ce qu’on n’a pas.

Applis détectées : oui. Le filtre app cible une appli (Klaviyo, Judge.me, Recharge…). Les applis d’abonnement restent peu détectées : 254 boutiques avec Recharge et 325 avec Bold Subscriptions en Europe au 31 octobre 2026, des chiffres bas à lire comme un plancher. Shopify Plus a son filtre : plan=shopify_plus garde les boutiques où un signal fiable le confirme (4 494 en Europe au 6 novembre 2026, la détection continue). C’est la seule valeur acceptée : il n’y a pas de filtre « pas Plus ».

Pas de champ secteur. Il n’existe pas de filtre secteur dans l’API aujourd’hui. Le catalogue produits (GET /v1/stores/{domaine}/catalog, jusqu’à 5 000 produits, pour une partie des boutiques) permet de classer vous-même.

Pas de quota, des crédits. Une page que votre solde ne couvre pas répond 402 avec le nombre de crédits nécessaires : baissez limit ou rachetez un pack. Jamais une page tronquée en silence, jamais de surfacturation.

Pas de SDK officiel. REST + JSON, c’est tout. La documentation complète est sur la documentation de l’API et sur la page API.

Export CSV. GET /v1/stores/export.csv prend les mêmes filtres que la recherche, renvoie jusqu’à 5 000 lignes par appel, avec le curseur de la page suivante dans l’en-tête X-Next-Cursor. Ajoutez bom=1 pour Excel.

Questions fréquentes pour ce cas d’usage

Voir aussi

• Équipes de prospection e-commerce : si vos collègues commerciaux ont besoin d’exports CSV sans écrire de code.
• Commercial Excel : si l’équipe vente préfère un fichier figé, payé une fois.
• Fusion-acquisition e-commerce : si vous travaillez sur un outil de sourcing fusion-acquisition.
• Fournisseurs en gros et dropshipping : si votre outil sert un vertical précis.

Branchez l’API à la place de l’outil maison. Documentation complète sur la documentation de l’API et la page API, prix des packs sur la page tarifs, retour aux 5 cas d’usage ou retour à l’accueil.