Documentation de l'API de données e-commerce

L'API SellWinners vous donne des données d'e-commerce et de publicité en HTTPS, avec des réponses JSON : les boutiques Shopify avec leurs produits et leur trafic ; les produits des boutiques avec leur prix, leurs estimations de ventes, leurs avis et leurs publicités ; les publicités Meta, Google et TikTok ; les annonceurs ; et les e-mails envoyés par les marques. Chaque endpoint est aussi accessible aux agents IA via notre serveur MCP hébergé. Cette page présente l'authentification, le format des réponses, la pagination, le tri et les filtres, les limites de débit et les crédits, les erreurs et les URL des médias, puis chaque endpoint avec ses paramètres et un exemple de requête, ainsi que les outils du serveur MCP.

Démarrage rapide

1. Créez un compte, confirmez votre e-mail et choisissez une offre payante : l'API et le serveur MCP sont accessibles à partir de là.
2. Ouvrez Clés API et créez une clé. Copiez-la tout de suite : elle ne s'affiche qu'une seule fois.
3. Envoyez votre première requête :

curl "https://api.sellwinners.com/v1/lookup?q=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

API = "https://api.sellwinners.com"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}

hit = requests.get(f"{API}/v1/lookup", params={"q": "allbirds.com", "type": "shop"}, headers=HEADERS).json()["data"][0]
shop = requests.get(f"{API}/v1/shops/{hit['shop']['id']}", headers=HEADERS).json()["data"]
print(shop["domain"], shop["traffic"]["monthlyVisits"])

const API = "https://api.sellwinners.com";
const headers = { "X-API-Key": process.env.API_KEY };

const found = await (await fetch(`${API}/v1/lookup?q=allbirds.com&type=shop`, { headers })).json();
const shop = (await (await fetch(`${API}/v1/shops/${found.data[0].shop.id}`, { headers })).json()).data;
console.log(shop.domain, shop.traffic.monthlyVisits);

Authentification

Envoyez votre clé API à chaque requête dans l'en-tête X-API-Key, ou comme jeton bearer :

X-API-Key: YOUR_API_KEY
# or
Authorization: Bearer YOUR_API_KEY

Les clés commencent par ak_live_. Gardez-les secrètes : ne les mettez pas dans du code front-end ni dans des dépôts publics. Vous pouvez créer plusieurs clés (une par application ou par environnement) et révoquer n'importe quelle clé depuis votre tableau de bord ; une clé révoquée cesse de fonctionner immédiatement.

Réponses

Chaque réponse est au format JSON. Elle contient un requestId et le résultat sous data : une liste pour les recherches et les listings, un objet pour une fiche unique. Les listes ajoutent un objet pagination, et certaines réponses ajoutent meta.

{
  "requestId": "req_8f2c1a9b4d7e6f3a2b1c0d9e",
  "data": [
    {
      "id": "facebook_1203948571620394",
      "platform": "facebook",
      "status": "active",
      "daysRunning": 42,
      "media": { "type": "video", "thumbnailUrl": "https://api.sellwinners.com/v1/media/file/b7a0.jpg", "mediaUrl": "https://api.sellwinners.com/v1/media/file/4c1e.mp4" },
      "advertiser": { "id": "104958372615", "name": "Glow Labs", "liveAdsCount": 86 },
      "content": { "title": "Glass skin in 14 days", "body": "Dermatologist tested.", "callToAction": "Shop now", "landingPageUrl": "https://glowlabs.example/serum" },
      "metrics": { "reach": 184000, "estimatedSpend": 1656, "duplicates": 3 },
      "audience": { "targetedCountries": ["FR", "DE"], "mainCountry": "FR" },
      "rank": { "currentRank": 4, "rankDelta": -2, "improvementPct": 0.3333 },
      "flags": { "isEuAd": true },
      "extra": { "shop": { "domain": "glowlabs.example" } }
    }
  ],
  "pagination": { "page": 1, "limit": 25, "total": 1840, "totalPages": 74, "hasMore": true }
}

Les fiches sont des objets imbriqués : une publicité contient media, advertiser, content, metrics, audience, rank et flags, et les boutiques, les annonceurs, les publicités Google, les éléments TikTok et les e-mails sont regroupés de la même façon. Une valeur inconnue vaut null. Les autres champs sans emplacement fixe sont regroupés sous extra. L'exemple ci-dessus est abrégé.

Dans une publicité, content.title est le titre et content.callToAction un texte lisible comme « Shop now ». metrics.estimatedSpend est l'estimation des dépenses de la source quand elle en a une (une publicité seule via /v1/ads/{adId} la lit), sinon portée x 9 / 1000 (9 USD pour 1 000 personnes touchées) ; une estimation des dépenses garde deux décimales sous 10 USD et s'exprime en dollars entiers à partir de 10 USD. rank.rankDelta est le rang actuel moins le précédent : une valeur négative signifie donc que la publicité est montée, et rank.improvementPct est une fraction (0,25 correspond à un quart).

Les rapports de rang du suivi de marques (/ad-rank, /scaling-ads, /v1/workspace/scaling-ads et l'outil MCP get_brandtracker_scaling_ads) ajoutent leurs propres metrics : là, metrics.rankDelta est le rang précédent moins le rang actuel (positif : places gagnées) et metrics.improvementPct est la fraction du rang précédent gagnée, comme dans une publicité (0,875 correspond à 87,5 %). Sur une publicité seule, metrics.reachDelta1d, reachDelta7d et reachDelta30d sont calculés à partir de son historique de portée. Les boutiques nomment leurs catégories : catalog.mainCategory dans les listings, plus catalog.categories sur une boutique seule.

Dans une publicité Google, media.type et media.format valent text, image ou video, et media.url est l'image de la publicité : pour une publicité vidéo, sa miniature (il n'y a pas de fichier vidéo). transparencyUrl est la publicité dans le Centre de transparence des publicités de Google, où une publicité vidéo est lue ; il vaut null quand la publicité n'a pas d'identifiants Google. network vaut search, youtube, shopping, maps ou other, tout comme les valeurs de extra.networks.

Modifié le 19 octobre 2026 :

• Le media.format d'une publicité Google était un code de format et vaut désormais text, image ou video, son media.type peut valoir text ou video, et extra.networks utilise les noms en minuscules de network.
• Un media.url Google n'est jamais un fichier vidéo, même lorsque media.type vaut video.
• Dans le filtre Google formats, image désigne désormais les publicités image (il désignait auparavant les publicités texte) : utilisez donc text pour les publicités texte. Les anciens codes static_image, html5_iframe et responsive_display, ainsi que leurs noms courts, sont toujours acceptés.

Le status d'une publicité Google ne vaut active que tant que Google affiche la publicité : une publicité que Google n'a pas affichée depuis plus de 7 jours vaut unknown. daysRunning compte les jours de firstSeenAt à lastSeenAt, tous deux inclus ; extra.servedDays est le décompte propre à la source de données, qui continue après l'arrêt d'une publicité. Les filtres concordent avec ce qu'affiche chaque publicité : status=active garde les publicités que Google a affichées au cours des 7 derniers jours et status=inactive celles que la source de données marque comme arrêtées, si bien qu'une publicité unknown ne relève d'aucun des deux ; minDaysRunning et maxDaysRunning gardent les publicités dont le daysRunning se situe dans la plage. Une telle liste a un pagination.total null, et lorsque peu des publicités lues correspondent, elle s'arrête tôt, avec meta.partial et un avertissement.

Sans texte de recherche, sortBy=relevance liste les plus récentes ; sortBy=reach n'accepte que order=desc. Avec status=active, sortBy=reach liste peu de publicités : dans l'ordre de portée, les premières publicités sont surtout des publicités que Google a cessé d'afficher, triez donc par les plus récentes pour obtenir les publicités que Google affiche maintenant (son avertissement le signale). Les publicités Google n'acceptent pas sortBy=longestRunning : la source de données le classe selon des jours qui continuent de s'accumuler après l'arrêt d'une publicité, si bien qu'il listait des publicités que Google n'affiche plus, et il répond 400 avec cette raison.

extra.startIsFloor signale une publicité vue pour la première fois le 31 mai 2018, premier jour des données publicitaires de Google : elle peut donc être plus ancienne. audience.countries liste tous les pays de l'audience, avec un percentage uniquement pour une publicité diffusée dans un seul pays ; remarketing et interest sont null lorsqu'ils sont inconnus.

Google n'indique une portée que pour certaines des publicités diffusées dans l'UE, souvent seulement sous la forme 10 000 000, le haut de son échelle (10 millions ou plus) : la plupart des publicités n'en ont pas, et nullReasons indique pourquoi reach.value est null (not_reported : une publicité diffusée dans l'UE pour laquelle Google n'en indique aucune ; eu_only : une publicité diffusée ailleurs), sauf pour une portée que l'offre exclut. extra.networks est la liste des plateformes de la publicité selon la source de données, qui peut ne pas nommer network. extra.shop.google contient les totaux Google du site web de l'annonceur ; pour un site qui n'est pas une boutique (une boutique d'applications, un réseau social, un raccourcisseur de liens), advertiser.domain et websiteId sont null.

Modifié le 20 octobre 2026 :

• Un domaine (GET /v1/shops/{domain}, le lookup, un domain TikTok, la synthèse sur un concurrent) désigne le site qui a exactement ce domaine, y compris en dehors de l'index des boutiques ; un domaine que la source de données n'atteint pas répond 404.
• GET /v1/lookup classe les résultats du meilleur au moins bon : le site du domaine lui-même, ses propres pages Facebook (page principale en premier), puis les pages au nom similaire ; pour un nom, le site de la marque elle-même et ses propres pages (page principale en premier), puis les boutiques et les pages trouvées par le nom.
• Lorsque le site de la marque est trouvé, une boutique ou une page qui ne contient le nom qu'à l'intérieur d'un mot est écartée, et un site portant ce nom n'est une correspondance exacte que s'il diffuse des publicités ; sinon, une correspondance de nom n'est exacte qu'avec du trafic ou des publicités. Les pages officielles d'un autre nom sans publicité active viennent après les pages trouvées par le nom.
• Le signals.activeAdsSource d'une ligne de boutique indique d'où viennent ses activeAds : page (les publicités actives de sa page principale, lues à l'instant, sur la ligne propre à la boutique) ou index (le décompte de l'index des boutiques, qui peut être plus ancien).
• Une recherche de boutique par domaine (searchType=domain) liste d'abord le site exact, avec extra.exactDomainMatch (et extra.inShopIndex à false lorsque l'index des boutiques ne le contient pas).
• Pour un site qui n'est pas une boutique (une boutique d'applications, un réseau social ou une messagerie, un raccourcisseur de liens ou une redirection de suivi), le extra.domain d'une ligne d'annonceur est null, une fiche d'annonceur le nomme dans extra.nonShopSite, omet extra.platforms et tire linkedShops de ses pages de destination (fromLandingPages), et une publicité n'a pas de shops.
• Les dates-heures que la source de données envoie sans fuseau horaire sont en UTC et sont désormais envoyées avec +00:00.
• Dans les statistiques d'e-mails, emailsByDayOfWeek a pour clé le numéro du jour : 0 pour dimanche, 6 pour samedi.
• Les lignes de lookup peuvent comporter nullReasons, et une fiche de boutique meta.partial lorsque les chiffres de son listing n'ont pas pu être lus.

Également modifié le 20 octobre 2026 (TikTok) :

• Le publishedAt d'un élément TikTok est en UTC. Il avait 1 ou 2 heures de retard : une publication faite dans les dernières heures d'une journée UTC apparaissait donc le lendemain, avec un daysRunning inférieur d'un jour.
• Les filtres concordent avec lui : publishedAfter et publishedBefore sont en UTC (une date seule correspond au début de sa journée, et publishedBefore liste les publications antérieures à celle-ci), minDaysRunning et maxDaysRunning comptent à partir du jour UTC, comme daysRunning, et sortBy=longestRunning commence au 31 août 2016, 22:00 UTC.

Également modifié le 20 octobre 2026 (publicités Google) :

• GET /v1/google-ads, POST /v1/google-ads/query et l'outil MCP n'acceptent pas sortBy=longestRunning (ni daysRunning) et répondent 400 avec la raison : la source de données le classe selon des jours qui continuent de s'accumuler après l'arrêt d'une publicité, si bien qu'il listait des publicités que Google n'affiche plus.
• Une recherche Free dont status=active réduit les premiers résultats répond avec meta.partial et un avertissement qui indique combien des publicités lues elle liste.
• Dans extra.shop, un site sans données de trafic n'a pas de monthlyVisits (il valait 0), un trafficGrowth30d n'apparaît qu'à côté de visites supérieures à 0, et extra.shop.google omet un totalReach ou un weeklyReach à 0 (jamais indiqué) et, lorsqu'il ne compte aucune publicité, les décomptes à 0.
• Une publicité Google enregistrée dans un tableau se lit de la même façon.

Également modifié le 20 octobre 2026 (boutiques) :

• Dans GET /v1/shops/{shopId}, advertising.summary.reach30d est la portée UE des 30 derniers jours, additionnée par date (c'était le total depuis le début du suivi, désormais totalReach), spend30d est cette portée x 9 / 1000, extra.estimatedSpendUsd est la dépense depuis le début du suivi et extra.adsLaunched30d additionne les publicités lancées au cours des 30 derniers jours ; tous sont null pour une boutique sans portée dans l'UE ou au Royaume-Uni.
• Les fiches de boutiques, les boutiques listées et les statistiques d'e-mails comportent nullReasons, qui associe le chemin d'un champ à la raison pour laquelle il est null : not_shopify (les ventes et les produits ne sont estimés que pour les boutiques Shopify), no_estimate, not_measured, eu_uk_only, not_linked (pas de profil TikTok), not_on_tp, no_reviews, none_found.
• Une estimation des ventes de zéro à côté d'unités vendues est null, dans les fiches, les listings et l'historique des ventes, dont le period=week a un point par semaine.
• traffic.growth30d est une fraction (-0,1543 correspond à -15,4 %), et traffic.history commence au premier mois avec des visites.
• catalog.mainCategory provient des id de catégorie (la plus précise de la branche principale), avec catalog.categoryLeaves et productsCountCapped (25 001 est le plafond de la source de données : 25 000 ou plus).
• Une page Trustpilot sans avis a une note null.
• tiktok.matchedBy vaut socials ou handle lorsque les chiffres TikTok proviennent des profils sociaux de la boutique ou d'un profil trouvé par son nom d'utilisateur (une correspondance, pas un lien de la source de données).
• advertising.mainPageActiveAds correspond aux publicités actives de la page principale (la lecture de sa vue d'ensemble publicitaire, telle que l'affiche sa page principale dans linkedAdvertisers ; le décompte des listes de boutiques n'est affiché qu'en l'absence de celle-ci) et linkedAdvertisers[].rank au rang de la page.
• Les boutiques similaires excluent la boutique elle-même et ses propres sites, et chaque page est complétée avec des boutiques situées plus bas dans la liste (offset et limit comptent la liste sans elles).
• Les produits triés par popularité placent en tête les meilleures ventes de la boutique (meta.order).
• Les e-mails et les statistiques d'e-mails d'une boutique comptent tous les types de campagne, et leurs chiffres sur 90 jours sont null lorsqu'ils sont inconnus.
• Un tri par ventes liste une ligne par boutique Shopify (extra.sharedSalesWith), et sortBy=estMonthlySales&order=asc exclut les boutiques sans estimation.

Également modifié le 20 octobre 2026 (chiffres des boutiques) :

• Un tri par ventes de GET /v1/shops poursuit la lecture au-delà des domaines qu'il fusionne en une ligne par boutique Shopify (il s'arrêtait après les premières lignes), fusionne aussi les domaines d'une boutique situés plus bas dans la liste, et son pagination.total est null tant que la liste n'a pas été lue jusqu'au bout ; sortBy=estMonthlySales&order=asc commence à une estimation de 100 USD (minMonthlySales 100).
• Une estimation des ventes inférieure à 0,50 USD par unité vendue est null (no_estimate), dans les fiches, les listings et l'historique des ventes.
• traffic.monthlyVisits est null pour un site pas encore mesuré, et traffic.growth30d lorsque le mois précédent n'a eu aucune visite (not_measured) ; le growth30d d'un réseau social provient de son historique d'abonnés lorsque la source de données donne 0 ou rien, et 0 abonné est null (not_measured).
• Les boutiques listées indiquent pourquoi catalog.productsCount et sales.unitsSold sont null.
• extra.storeWide signale un domaine à 0 visite qui porte les ventes de sa boutique (un 0 mesuré, ou bien un autre domaine de la boutique, nommé dans extra.sharedSalesWith, a les visites ; Free omet ce nom dans une fiche de boutique).
• advertising.mainPageActiveAds correspond aux publicités actives de la page principale telles que les lit sa vue d'ensemble publicitaire (le décompte des listes de boutiques n'est affiché qu'en l'absence de celle-ci).
• Les boutiques similaires excluent aussi les boutiques de la marque de la boutique, et extra.similarIndexed vaut false pour une boutique que l'index de similarité ne contient pas.
• catalog.mainCategory ne conserve le libellé propre à la source de données que lorsqu'il s'agit du nom d'une catégorie.
• Un fichier média lié dans une réponse et que la source de données n'a plus répond 200 avec un corps vide et X-Media-Missing: true.

Également modifié le 20 octobre 2026 (annonceurs et publicités Meta) :

• La portée d'un annonceur est la portée dans l'UE et au Royaume-Uni, sur les fenêtres propres à la recherche d'annonceurs : advertising.reach30d, extra.reach14d, reach90d et totalReach sont null pour une page sans publicités dans l'UE ou au Royaume-Uni et sans portée, ou pour une fenêtre que la source de données n'a pas comptée, et nullReasons indique pourquoi (eu_uk_only, not_measured) ; une page créée au cours d'une fenêtre y a toute sa portée (elles valaient 0).
• Dans GET /v1/advertisers/{advertiserId}, la portée est celle qu'affichent les listes d'annonceurs (elle était lue 30 relevés en arrière, et les relevés sautent des jours), les estimations de dépenses sont null avec elle, extra.avgSpendUsd14d est la dépense quotidienne moyenne sur 14 jours, extra.avgActiveAds14d est la moyenne sur 14 jours de ses publicités actives (c'était ses nouvelles publicités sur 14 jours) ; là où la source de données ne l'a pas calculée, elle est tirée, pour une page créée au cours des 14 jours, de ses publicités actives lues depuis son premier jour (extra.averagedFrom), et elle est null sinon ; enfin, les décomptes de nouvelles publicités d'une page créée au cours de la fenêtre comptent chacune de ses publicités.
• advertising.countryDistribution est la part de ses publicités actives qui ciblent chaque pays (une publicité en cible plusieurs), extra.reachCountries contient la part de chaque pays dans la portée UE, extra.platforms.meta contient les publicités propres à la page (il contenait celles de la page principale de la boutique), un décompte TikTok ou Google sans chiffre est omis, extra.mainLandingPages se rabat sur l'aperçu des pages de destination d'une nouvelle page, et les lastAds d'une page dont la recherche de publicités n'a pas encore intégré les publicités sont les plus récentes que liste sa ligne d'annonceur, avec meta.indexing, comme sur GET /v1/advertisers/{advertiser_id}/ads (avec meta.liveAds).
• Nouveau : GET /v1/advertisers/{advertiserId}/history, les publicités actives de la page et la portée UE qu'elle a gagnée, jour par jour.
• Un nombre d'abonnés Instagram de 0 est null (la source de données écrit 0 pour une page dont elle ne connaît aucun compte).
• La metrics.reach d'une publicité Meta et ses dépenses sont null pour une publicité non diffusée dans l'UE ou au Royaume-Uni (eu_uk_only ; elles valaient 0 ou null) et pour une publicité de l'UE dont la portée n'est pas encore comptée (not_measured ; elle valait 0), les lignes de médias indiquant pourquoi dans nullReasons.reach ; media.type vaut carousel pour une publicité de plus d'une image ou d'une vidéo, et extra.startIsFloor signale une publicité lancée le 1er janvier 2018, premier jour des dates de publicités Meta de la source de données.
• sortBy=adRank liste en premier le meilleur rang (1), quel que soit l'ordre.
• Une publicité seule (GET /v1/ads/{adId}) prend la dernière portée indiquée par la source de données et la dépense correspondante, calcule ses variations de portée par date tant que son historique de portée est à jour (sinon elles sont null), liste ses images et ses vidéos comme le fait sa ligne de recherche, remplit advertiser.reach30d et pageAnalytics.instagramFollowersHistory, ajoute pageAnalytics.reachHistory (la même série que impressionsHistory), et nomme une boutique que la fiche ne donne que par son id (son traffic étant null avec nullReasons shops.traffic lorsque le site n'est pas mesuré) ; ses audience.gender, ageMin, ageMax et metrics.aggregatedReach sont toujours null, car la source de données ne les indique pas pour une publicité seule.
• Dans une recherche d'annonceurs, sortBy=reach classe selon la portée totale depuis le début du suivi, et newAds selon les nouvelles publicités sur 14 jours.
• Le ciblage d'une publicité Meta indique pourquoi sa portée est null : eu_uk_only uniquement pour une publicité qui ne cible aucun pays de l'UE ni le Royaume-Uni ; une publicité qui en cible un, ou dont le ciblage n'est pas encore connu, est not_measured pendant ses 7 premiers jours et not_reported ensuite (elles étaient eu_uk_only), dans les listings de publicités, les lignes de médias et une publicité seule.
• Une publicité seule lit ses historiques de portée et de dépenses comme une seule série, un relevé par jour (ses variations aussi), et prend le dernier relevé de cette série et sa dépense lorsque la portée de la fiche en représente plus du double et que la série va jusqu'au dernier jour de la publicité ; son media se rabat sur son premier fichier listé, et advertiser.totalReach sur la portée UE des détails de la page.
• Une fiche d'annonceur dont la ligne ne lit aucune portée alors que les détails de la page en lisent une prend leur portée (extra.totalReach, la dépense correspondante, advertising.reach30d calculé sur celle-ci), ses parts extra.reachCountries ne sont jamais arrondies à 0, extra.averagedFrom n'est jamais antérieur au jour de création de la page, et son historique quotidien (extra.history, GET /v1/advertisers/{advertiserId}/history) omet les relevés manqués par la source de données (une série de zéros de 14 jours ou moins entre des relevés supérieurs à 0).
• Une publicité seule qui prend le relevé de sa série conserve la portée de la fiche dans extra.recordReach (le chiffre qu'affichent les listings de publicités) ; dans une recherche d'annonceurs, une ligne qui ne lit aucune portée UE alors que les détails de la page en lisent une prend leur portée, comme sa fiche ; et GET /v1/advertisers/{advertiserId}/history conserve les relevés à 0 d'une page qui n'a aujourd'hui aucune publicité dans l'UE mais qui a gagné de la portée avant les jours demandés (elle n'en a gagné aucune ; ces relevés étaient omis comme not_measured).
• Avec Free, une publicité dont la portée est inconnue en indique la raison comme sur les offres payantes ; seule une portée que l'offre exclut n'a pas de raison.

Également modifié le 20 octobre 2026 (estimations de dépenses) :

• Une dépense estimée inférieure à 10 USD garde deux décimales : une portée de 140 à 9 USD pour 1 000 personnes touchées donne 1,26 (c'était 1), et une moyenne quotidienne garde ses propres centimes ; à partir de 10 USD, une estimation de dépenses s'exprime en dollars entiers (une portée de 2 000 donne 18).
• Cela vaut pour extra.estimatedSpendUsd et extra.avgSpendUsd14d de la fiche d'annonceur, pour advertising.summary.spend30d et extra.estimatedSpendUsd d'une boutique, pour metrics.estimatedSpend d'une publicité Meta, ainsi que pour statistics.euData.estimatedSpend30d d'un suivi de marque et l'estimatedSpend de chaque point de /time-series (les deux avaient deux décimales quel que soit le montant), dans l'API comme dans les outils MCP. Lorsque le chiffre propre à la source de données est cette estimation en dollars entiers, il garde ses centimes de la même façon.

Également modifié le 20 octobre 2026 (portée des annonceurs et historique quotidien) :

• GET /v1/advertisers/{advertiserId} ajoute extra.reachScope : outside_eu_uk pour une page dont la portée par pays a surtout été relevée hors de l'UE et du Royaume-Uni (la source de données indique aussi la portée de certaines publicités diffusées ailleurs ; sa portée et les estimations qui en découlent sont alors cette portée, et non une portée UE), sinon eu_uk. Son extra.avgSpendUsd14d, pour une page créée au cours des 14 jours, est sa dépense rapportée à l'ensemble des jours écoulés depuis sa création (un au moins ; c'était sa portée sur 14 jours rapportée à 14 jours lorsque la ligne d'annonceur en avait une).
• Le extra.history de la fiche d'annonceur et GET /v1/advertisers/{advertiserId}/history commencent le jour de création de la page ; extra.history.newAds omet ses 0 des jours manqués par la source de données, extra.followersHistory et les mentions J'aime et abonnés du pageAnalytics d'une publicité omettent un 0 situé entre deux relevés supérieurs à 0 ou relevé un tel jour, et les estimations de dépenses quotidiennes gardent deux décimales sous 10 USD.
• Une page dont aucune liste ne contient encore les publicités actives a meta.indexing sur sa fiche, et une première page vide de GET /v1/advertisers/{advertiser_id}/ads avec meta.indexing et meta.liveAds.
• Une publicité seule (GET /v1/ads/{adId}) : extra.spendHistory commence le jour où la publicité a démarré, chaque spendUsd avec deux décimales sous 10 USD ; advertiser.totalReach n'est jamais inférieur au dernier relevé de pageAnalytics.reachHistory (extra.pageRecordReach contient alors le total de la fiche, celui qu'affichent les listes d'annonceurs) ; extra.recordSpend est la dépense de extra.recordReach ; extra.reachScope et extra.pageReachScope indiquent où la majeure partie de la portée de la publicité et de celle de sa page a été relevée.

Également modifié le 20 octobre 2026 (suivis de marques) :

• Dans GET /v1/brandtrackers et GET /v1/brandtrackers/{id}, un 0 pour advertising.newAdsLastDay à côté de lancements au cours des 7 derniers jours est vérifié par rapport aux lancements de la boutique de la veille : leur nombre, ou null (not_measured) sans relevé ce jour-là ; un listing vérifie au plus 20 marques par appel, celles de la page demandée.
• Dans /top-ads et /v1/workspace/top-ads, metrics.totalReach est la portée UE de la publicité : null pour une publicité diffusée hors de l'UE et du Royaume-Uni (eu_uk_only) ou pour une publicité de l'UE pas encore comptée (not_measured), avec nullReasons, et en dernier dans un tri par portée (elle valait 0).
• /testing calcule ses statistiques de portée sur les publicités dont la portée est connue, avec nullReasons stats.reach pour un lot qui n'en a aucune.
• Dans /hooks, /transcripts, /landing-pages et les accroches et pages de destination de l'espace de travail, un totalImpressions de 0 est null avec la nouvelle raison no_eu_reach (aucune portée UE ou Royaume-Uni comptée pour ses publicités ; not_measured avec euOnly), et vient en dernier dans son tri.
• Dans /ad-rank, /scaling-ads et /v1/workspace/scaling-ads, lorsque l'historique de rang d'une publicité commence au cours d'une fenêtre de 14 ou 30 jours, metrics.previousRank et rankDelta comptent à partir de son plus ancien relevé dans cette fenêtre : metrics.since est ce jour-là et meta.windowNote le signale, et un chiffre qui ne peut pas être donné est null avec nullReasons.
• Dans /partners, isOwnPage vaut true pour la page principale de la boutique, ses pages officielles nommées comme la marque et une page nommée comme la marque (les créateurs peuvent aussi être classés comme officiels), et une portée ou une dépense null a nullReasons.
• La première page de /ads avec adCopyHashes a meta.latestAdDate et dataFreshnessLagDays, et, avec status=active, meta.stoppedCount.
• /demography correspond à l'audience dans l'UE et au Royaume-Uni, et un pays inférieur à un dix-millième du premier passe de countryDistribution à otherCountries.
• /ad-copy-evolution et /headline-evolution ont un point pour chaque jour enregistré (0 lorsque le texte n'a pas été utilisé, null un jour tronqué aux textes qu'il conserve), classent les textes selon le jour le plus récent et omettent les jours mal lus par la source de données (des publicités actives inférieures à un dixième de celles des jours voisins, sur un jour ou 2 ou 3 d'affilée, ou bien beaucoup moins de textes que les jours de part et d'autre), comme l'indique meta.periodNote ; meta.recordedDays compte les jours. Les publicités actives hebdomadaires et mensuelles de /time-series omettent aussi 2 ou 3 relevés de ce type d'affilée.

Également modifié le 20 octobre 2026 (rapports du suivi de marques, lookup et portée Google) :

• Dans /ad-rank, /scaling-ads et /v1/workspace/scaling-ads, chaque rang d'une ligne provient de l'historique de rang de la publicité : metrics.currentRank est son relevé du jour où le rang de la bibliothèque publicitaire a été lu (le rang qu'affiche /top-ads ; la bibliothèque peut avoir un jour de retard sur l'historique), sinon son relevé le plus récent, la trajectory se termine ce jour-là, et en l'absence de relevé le jour où la fenêtre commence, c'est le plus ancien relevé à l'intérieur de celle-ci qui compte (la variation propre à la source de données sur la fenêtre n'est plus utilisée).
• Les 50 premières publicités de la bibliothèque publicitaire (10 par marque pour l'ensemble des marques) sont reclassées selon ces chiffres : une publicité qui a gagné moins que minRankDelta, ou qui se classe en dessous de maxCurrentRank, selon eux est écartée (pour une publicité dont l'historique de rang ne donne aucun gain, c'est le décompte propre à la bibliothèque publicitaire qui s'applique), pagination couvre les publicités conservées et meta.rankNote indique ce qui a été lu et écarté, y compris pour l'ensemble des marques.
• Un /time-series quotidien (et le graph de la vue d'ensemble) est null un jour dont la source de données a mal lu les publicités actives (moins d'un dixième des jours de part et d'autre ; le jour le plus récent reste tel que lu, dans les évolutions de texte aussi), ses lancements aussi, de même que les lancements du lendemain lorsqu'ils représentent presque toutes ses publicités actives ; les semaines et les mois omettent ces lancements, et leftOut liste les jours. /landing-page-evolution omet ces jours de chaque page, ainsi que le relevé propre à une page inférieur à un dixième des relevés de part et d'autre, comme l'indique son meta.periodNote, avec le jour qu'atteint l'historique lorsqu'il est en retard.
• Un lot /testing sans portée comptée a nullReasons stats.reach no_eu_reach, sauf si l'une de ses publicités n'est pas encore comptée (not_measured) ou si toutes ont été diffusées hors de l'UE et du Royaume-Uni (eu_uk_only) ; la portée et la dépense manquantes d'une ligne /partners ne sont not_measured que pendant les 7 jours qui suivent son launchDate, et no_eu_reach ensuite.
• /creatives nomme carousel une publicité de plusieurs images ou vidéos (c'était unknown).
• Dans GET /v1/lookup, le signals.monthlyVisits d'une boutique est null pour un site pas encore mesuré (nullReasons not_measured ; il valait 0), les publicités actives de la ligne de boutique exacte (avec chaque type, shop compris) sont celles de sa page principale telles que les lit sa vue d'ensemble publicitaire, son mainPageActiveAds, et les lignes des pages propres à la boutique lisent les leurs de la même façon ; le signals.monthlyVisits d'une marque suivie (et son totalTraffic dans GET /v1/brandtrackers) est null pour un site pas encore mesuré et indique pourquoi il manque (not_measured, ou no_shop pour une page sans boutique), et avec Free, la portée d'une page qu'aucune offre ne fournit conserve sa raison (eu_uk_only, not_measured), dans les listes d'annonceurs aussi.
• Le reach.value null d'une publicité Google a nullReasons (not_reported, eu_only), sauf pour une portée que l'offre exclut.
• Dans GET /v1/shops/{shopId}, advertising.mainPageActiveAds correspond aux publicités actives de la page principale telles que les lit sa vue d'ensemble publicitaire, le décompte qu'affiche sa page principale dans linkedAdvertisers (c'était le décompte de l'index des boutiques, qui peut dater d'un jour de plus).

Également modifié le 20 octobre 2026 (TikTok et e-mails) :

• Le metrics.engagementRate d'une ligne TikTok est (mentions J'aime + commentaires + partages + enregistrements) / vues, exprimé en fraction (0,0513 correspond à 5,13 % ; les recherches envoyaient un pourcentage et GET /v1/tiktok/library/{itemId} une autre mesure), et daysRunning correspond aux jours écoulés depuis la publication du post, dans les deux cas.
• metrics.rank est le rang du post parmi les posts de son créateur (1 est le meilleur).
• profile.followers est null lorsque la source de données ne les a pas comptés (elle envoyait 0), content.category est null pour sa catégorie fourre-tout All, et content.hashtags sont les tags du post, chacun une seule fois, orthographiés comme dans sa description et sans la ponctuation qui les suit (ceux d'une fiche sont la liste qu'en donne la source de données, ceux d'une ligne de recherche sont ceux de la description).
• Une fiche TikTok ajoute profile.adsCount, organicCount et avgPostsPerWeek90d, remplit profile.pageCreation, et a des links null pour une ligne de la source de données sans TikTok derrière elle (un id de moins de 15 chiffres, ou publié avant le 31 août 2016, 22:00 UTC).
• sortBy=longestRunning commence aux premiers TikToks (31 août 2016, 22:00 UTC).
• Une fiche d'e-mail nomme son type de promotion, sa catégorie et son événement, et les visites mensuelles, les publicités actives, les produits et les chiffres sur 90 jours de sa boutique sont ceux qu'affichent les listes d'e-mails, tout comme les chiffres last90Days des statistiques d'e-mails.
• Une ligne d'e-mail omet extra.shopActiveAds pour un 0 sans total de publicités (ses nullReasons indiquent not_measured), et le shop.marketing.activeAds d'une fiche d'e-mail est alors null ; lorsque les chiffres de la boutique n'ont pas pu être lus, la fiche a meta.partial, un avertissement et nullReasons failed pour ces chiffres.
• Dans l'outil MCP analyze_shop_emails, dominant classe les types de campagne, les catégories, les types de promotion et les événements chacun séparément, et omet No Promotion et No Event.

Modifié le 21 octobre 2026 :

• Les metrics.views d'un élément TikTok, ainsi que ses likes et saves qui valent 0 à côté, sont null avec nullReasons not_measured (tout comme engagementRate) lorsque la source de données a envoyé 0 vue à côté de mentions J'aime, de commentaires, de partages ou d'enregistrements supérieurs à 0, dans les recherches et dans GET /v1/tiktok/library/{itemId} ; sortBy=views ou likes avec order=asc liste les posts dont les vues sont comptées (minViews 1).
• Une recherche de publicités Meta avec websiteIds liste les publicités propres aux boutiques : toutes les publicités de la page principale d'une boutique et de ses pages officielles portant le même nom, ainsi que les publicités de ses autres pages (créateurs, éditeurs et partenaires qui ont diffusé ses publicités) qui renvoient vers la boutique ou vers un site de son domaine ; tant que la liste n'a pas été lue jusqu'au bout, le pagination.total de la recherche correspond alors aux publicités des pages propres à la boutique recherchées, une estimation (pagination.totalEstimated à true), ou est null lorsque la recherche ne nomme aucune de ses propres pages.
• Avec sortBy=longestRunning, chaque lot de publicités lu depuis la source de données est trié par daysRunning.
• Dans GET /v1/shops/{shopId}, advertising.activeAds compte les publicités actives des pages propres à la boutique (linkedAdvertisers[].isOwnPage), et dans son /products, une meilleure vente classée a le titre, le prix et l'image de catalog.bestSellers (le prix d'une meilleure vente peut être le plus bas de ceux de ses variantes).
• Le traffic.monthlyVisits d'une boutique (et son growth30d) est null avec not_measured lorsqu'il vaut 0 parce que son historique est tombé à 0 alors qu'il existe une estimation des ventes supérieure à 0 et des unités vendues, dans les fiches, les boutiques listées et similaires et le lookup ; un tel domaine reste extra.storeWide.
• Dans GET /v1/ads/{adId}, advertiser.totalReach est le dernier relevé de pageAnalytics.reachHistory tant que ce relevé date de 2 jours au plus (extra.pageRecordReach contient alors le total de la fiche), extra.advertiserTotalAds est rempli à partir des chiffres listés de la page (not_measured en leur absence), les gains de portée sur 7 et 30 jours d'une publicité lancée au cours de la fenêtre correspondent à toute sa portée, et un gain inférieur à celui d'une période plus courte est null (not_measured).
• Le statistics.ctaCount d'un suivi de marque nomme chaque appel à l'action comme le fait content.callToAction (« Shop now »).

Également modifié le 21 octobre 2026 (boutiques) :

• Dans GET /v1/shops/{shopId}, advertising.history correspond aux publicités actives de la page principale par jour sur toutes les offres (avec Free, il comptait celles de toutes les pages), et la documentation précise que la portée et les dépenses de advertising.summary, extra.adsLaunched30d, extra.totalAds et extra.estimatedSpendUsd couvrent toutes les pages de la boutique, alors que advertising.activeAds compte ses propres pages.
• Un catalog.productsCount de 0 pour une boutique sans produit listé, à côté de visites, d'une estimation des ventes ou d'unités vendues, est null avec not_measured, dans les fiches, les boutiques listées et le meta.productsCount de GET /v1/shops/{shopId}/products ; sortBy=productsCount exclut ces boutiques et, avec order=asc, envoie minProductsCount 1, sauf si un minimum de produits est indiqué.
• Une recherche de publicités Meta d'une boutique restreinte à des pages qui ne lui appartiennent pas (trackedPages) et qui s'arrête tôt en indique la raison dans meta.warnings, sans demander de la restreindre.
• GET /v1/filters/shops signale dans meta.warnings lorsque la source de données ne liste aucune valeur, et nomme les listes qui les fournissent.

Également modifié le 21 octobre 2026 (pagination, e-mails et listes de publicités) :

• La pagination d'une recherche d'annonceurs n'échoue plus lorsque la source de données refuse de la poursuivre (elle répondait 503, et réessayer n'y changeait rien) : ses 100 premiers résultats sont lus en un seul appel, et la page qui atteint la fin de ce qui peut être lu répond hasMore à false, avec meta.partial à true et un avertissement qui indique jusqu'où la recherche lit.
• Une page qui commence au-delà du total exact d'une recherche est vide, avec hasMore à false.
• Une recherche TikTok triée par views ou likes avec order=asc commence aux premiers TikToks (31 août 2016, 22:00 UTC), comme longestRunning, et le metrics.views d'un élément TikTok (et son engagementRate) est null avec not_measured lorsqu'il indique moins de vues que de mentions J'aime.
• Le content.bodyPreview et le bodyLength d'un e-mail, ainsi que le content.body d'une fiche, sont null avec not_measured lorsque la source de données a envoyé son texte de substitution pour un corps qu'elle n'a pas lu.
• Les dates-heures que la source de données fournit en UTC s'écrivent de la même façon dans les listes et dans les fiches, avec +00:00 et sans zéros finaux dans la fraction de seconde (2026-09-30T00:20:11.507+00:00 ; les heures de création ou de modification de vos propres tableaux, favoris, suivis de marques et liens de partage se terminent par Z, comme avant), et les lignes d'e-mails comportent les id de leur catégorie, de leur type de promotion et de leur événement, comme la fiche de l'e-mail.
• Chaque liste paginée renvoie pagination.hasMore, et GET /v1/google-ads/facets/countries renvoie un objet pagination.
• Un corps de requête qui n'est pas du JSON valide répond 400 validation_failed avec le message « The request body is not valid JSON. » et details.position, le caractère où il s'interrompt.
• Dans les listes de publicités Meta, la portée d'une ligne est le relevé de l'index des publicités, qui peut avoir un jour de retard sur la fiche de la publicité, et ses gains de portée sont null à côté d'une portée connue lorsque la source de données n'en liste aucun (not_measured), sauf sur une fenêtre au cours de laquelle la publicité a démarré, où elle a gagné toute la portée qu'indique sa ligne ; dans GET /v1/ads/{adId}, un gain null à côté d'une portée connue a lui aussi not_measured.

Modifié le 22 octobre 2026 (l'offre Free) :

• L'API et le serveur MCP sont passés aux offres payantes : une clé d'un compte sur l'offre Free répondait 403 plan_not_eligible sur tous les endpoints sauf GET /v1/account, avec details.upgradeUrl, et rien n'était décompté. Aucune clé ne pouvait être créée avec Free.
• L'offre Free a changé depuis : L'offre Free indique ce qu'elle inclut aujourd'hui.
• Une clé créée sur une offre payante est conservée, et elle fonctionne de nouveau dès que le compte repasse sur une offre payante. Les liens de partage créés par un compte sur Free sont suspendus de la même façon.

Également modifié le 22 octobre 2026 (rapports et fiches de boutiques) :

• Dans GET /v1/shops/{shopId}/ad-ranking/series, rankDelta est le rang de fin moins le rang de début (négatif quand la publicité est montée, comme pour toute publicité ; c'était les places gagnées) et improvementPercent devient improvementPct, une fraction ; chaque ligne de /ad-ranking comporte les deux mêmes chiffres sur la fenêtre du classement dans rank.
• Dans le /activity/calendar d'une marque suivie, un jour du calendrier et /activity/calendar/days, meta.partial vaut true ou false, meta.partialSources nomme les sources lues en partie (sur /calendar et un jour), et les heures des aperçus sont en UTC, y compris celle d'un post TikTok.
• Dans GET /v1/shops/{shopId}/landing-pages/detail, activeAds se rabat sur les publicités de la page, shareOfAds correspond à linkedAdsTotal sur shopActiveAds, snapshots compte les jours où la page a été capturée, lifetimeAds et impressions disparaissent (les impressions reprenaient la portée), une portée de 0 est null avec nullReasons.reach no_eu_reach, et les linkedAds ont les champs des lignes d'une recherche de publicités.
• Le /feed d'une boutique liste ses propres publicités Meta, comme le font ses recherches de publicités.
• GET /v1/market/q4-overview accepte n'importe quels from et to à l'intérieur de la saison.
• Dans /q4-season, winners liste la clé de chaque promotion avec ses visuels, et les URL des pages de destination comportent leur schéma.
• Les détecteurs Shopify lisent une boutique à son domaine sans www..
• GET /v1/advertisers/{advertiserId} ainsi que les pages de destination, l'audience et la répartition des médias d'une marque suivie renvoient un jour passé dans meta.snapshotDate.
• Lorsque les statistiques de publicités Meta d'une boutique ne peuvent pas être lues à ce moment-là, GET /v1/shops/{shopId} répond meta.partial à true avec un avertissement : sa portée, les estimations de dépenses qui en découlent et sa répartition des médias et des formats sont null avec nullReasons failed, ses publicités par pays sont comptées telles que les donne sa ligne de recherche, et la réponse n'est pas conservée, si bien que l'appel suivant les relit (la synthèse sur un concurrent comporte le même meta.partial et les mêmes avertissements).
• Une page de destination sur le domaine propre à la boutique, ou sur l'un de ses sous-domaines, a toShop à true dans /v1/shops/{shopId}/advertisers et /advertisers/{advertiserId}/landing-pages ; lorsque les domaines de la boutique n'incluent pas ce domaine, meta.domains le liste en premier à partir des pages de destination de ses pages (fromLandingPages à true, une borne inférieure), et le shopAds d'une page n'est jamais inférieur aux publicités actives de ses pages de destination sur la boutique (shopAdsAtLeast à true lorsqu'il est relevé).
• Dans GET /v1/tiktok/library/{itemId}, profile.latestPosts[].mediaUrl est la vidéo du post, ou null avec nullReasons not_reported (c'était l'image de couverture).
• Une recherche d'annonceurs lit ses 100 premiers résultats et indique qu'elle se termine sur la page qui atteint le 100e (hasMore à false et l'avertissement), et non sur la page vide qui suit.
• Une recherche TikTok triée par views ou likes avec order=asc exclut désormais les posts dont les vues ne sont pas comptées (moins de vues que de mentions J'aime), et son pagination.total est une estimation (totalEstimated) tant que la liste n'a pas été lue jusqu'au bout ; tous les autres ordres les listent, avec des vues null.

Également modifié le 22 octobre 2026 (éléments enregistrés et accroches publicitaires) :

• Nouveau : GET /v1/boards/search retrouve ce que vous avez enregistré, dans tous les tableaux et vos favoris, à partir des mots qu'affiche chaque copie enregistrée (chaque mot doit apparaître, dans n'importe quel ordre ; la casse et les accents sont ignorés), de son id ou du nom de son tableau, et accepte sourceType, boardId, savedFrom et savedTo ; il ne lit que vos éléments enregistrés, jamais la source de données (MCP find_saved_items).
• Nouveau : POST /v1/tools/ad-hooks rédige trois courtes phrases d'accroche pour une publicité de votre produit, et GET /v1/tools/ad-hooks indique votre quota : pas de limite mensuelle sur les offres payantes, et une limite par minute (429 avec Retry-After) ; la lecture du quota n'est pas décomptée (MCP write_ad_hooks).
• Le serveur MCP compte 64 outils.

Également modifié le 23 octobre 2026 (vues enregistrées et filtres de boutiques) :

• Nouveau : GET /v1/views liste les recherches que vous avez enregistrées sur les pages de liste du site, chacune avec la recherche qu'elle effectue (request : la recherche, searchType, sortBy, order et les filtres nommés, tels que les acceptent les endpoints de recherche) ; POST /v1/views en enregistre une, PATCH /v1/views/{viewId} la renomme, la déplace ou la modifie et DELETE /v1/views/{viewId} la supprime. Ils ne lisent et n'écrivent que vos propres vues, jamais la source de données (MCP list_saved_views).
• Les recherches de boutiques acceptent excludeCurrencies (des codes de devise comme EUR), socialNetworks (instagram ou tiktok : une boutique qui a l'un d'eux) et shopifyPlan (headless). trafficGrowth lit aussi 90 jours (min90, max90) et adsGrowth 7 jours (min7, max7), ou le period d'une règle (last90d, last7d) ; min et max restent les 30 derniers jours.
• Le serveur MCP compte 65 outils.

Également modifié le 23 octobre 2026 (liens des produits) :

• Dans GET /v1/shops/{shopId}, chacun des catalog.bestSellers comporte handle et productUrl, la page du produit sur le site propre à la boutique : l'adresse que donne la source de données lorsqu'elle se trouve sur le domaine de la boutique (ou l'un de ses sous-domaines) ou sur son domaine myshopify, sinon https://<domain>/products/<handle> lorsque son handle est connu, sinon null.
• Dans GET /v1/shops/{shopId}/products, productUrl suit la même règle, si bien qu'une adresse sur un autre site n'est plus donnée, et handle est null lorsqu'il ne correspond pas à une seule partie d'une adresse.

Également modifié le 23 octobre 2026 (lignes de boutiques, boutiques similaires et produits) :

• Le createdAt d'une boutique (la fiche de boutique, les lignes de boutiques et les boutiques similaires) n'est la date de création que pour une boutique Shopify. Pour un site hors Shopify, la source de données donne le jour où elle a commencé à suivre le site, et non sa création : createdAt est désormais null (nullReasons tracking_date) et ce jour devient le nouveau trackedSince. Une date antérieure ou égale au 1er janvier 2000 est la valeur de substitution de la source de données et est null (not_reported).
• Les catalog.bestSellers des lignes de boutiques comportent handle, productUrl (selon la règle de la fiche de boutique) et rank (1 est la meilleure vente), et les lignes comportent profile.isHeadless et catalog.myShopifyDomain, comme la fiche de boutique.
• Le googleAds.reach.value d'une ligne de boutique est null : les lignes de boutiques ne comportent pas de portée Google, qui figure sur la fiche de boutique (extra.googleAds.reach).
• Les boutiques similaires (GET /v1/shops/{shopId}/similar, les similarShops de la fiche) conservent leur extra (logo, Trustpilot, historique des ventes). Une liste de boutiques similaires que la source de données arrête avant la fin répond meta.partial et un avertissement sur la page qui atteint ce point.
• Dans GET /v1/shops/{shopId}/products, createdAt et publishedAt correspondaient à l'heure propre à la boutique envoyée comme UTC (8 heures d'avance pour une boutique à l'heure du Pacifique américain). Ils sont désormais en UTC, avec le nouveau updatedAt, à partir du décalage de la boutique par rapport à UTC (meta.shopUtcOffset, comme -08:00). Lorsqu'aucun décalage ne peut être lu, les trois sont null (local_time) et createdAtLocal, publishedAtLocal et updatedAtLocal donnent l'heure de la boutique, sans fuseau horaire.
• Un produit listé uniquement parmi les meilleures ventes des détails de la boutique a un publishedAt et un updatedAt null (not_reported) : ceux de la source de données étaient des copies de son heure de création.
• Chaque produit indique dans quelles listes il figure (lists : bestSellers, newest) et sa place parmi les meilleures ventes (listPosition, de 1 à 100).

Également modifié le 23 octobre 2026 (fiches de boutiques) :

• Dans GET /v1/shops/{shopId}, extra.googleAds.reach.value était toujours null : c'est désormais la portée Google de la boutique dans l'UE, avec lowerBound et upperBound, et extra.googleAds ajoute reachHistory, history (ses publicités Google marquées actives, par semaine), updatedAt et latestAds.
• Le growth30d d'un réseau social correspond désormais à l'évolution sur 30 jours de la vue d'ensemble des abonnés (c'était une autre fenêtre pour certaines pages Facebook : 0,3636 là où l'évolution était de 0,2898). GET /v1/shops/{shopId}/socials le fournit aussi sous la forme growth30d.
• Le profil X de la boutique est socials.x. socials.twitter est renommé socials.x et reste disponible, sous la forme du même objet, pendant une version. Chaque réseau a une url, et socials.others liste les autres liens de la boutique.
• tiktok.profileMetrics.percentAds est un pourcentage (de 0 à 100) ; le nouveau adsShare donne la même valeur sous forme de fraction. tiktok ajoute avatarUrl, history, postsChange30d, postsChange30dPct et latestAds, et tiktok.activity.avgActiveAds7d et avgActiveAds30d, auparavant null, font la moyenne de ses publicités TikTok par jour.
• Nouveau sur les offres payantes : advertising.summary.firstAdSeenAt, longestRunningDays, medianRunningDays, landingPagesCount et les évolutions sur 30 jours des publicités actives, des publicités lancées et de la portée UE (activeAdsChange30d, launchedChange30d, reachChange30d, chacune aussi sous forme de fraction, …Pct), ainsi que advertising.runningDaysMix, reachCountries, reachHistory, topLandingPages, adsByAgeRange et adsByGender. Sur toutes les offres : advertising.allPagesHistory et advertising.topCountries[].ads.
• Nouveau : catalog.bestSellers[].rank, sales.hasSubscription, technology.apps[].appStoreUrl et categories, profile.isHeadless, extra.updatedAt, ainsi que les createdAt et trackedSince des dates de boutique ci-dessus.
• GET /v1/shops/{shopId}/advertisers ajoute le logoUrl et les moreLandingPages de chaque page, un profileUrl lorsque la vue d'ensemble publicitaire n'en a pas, ainsi que le landingPagesCount et les moreLandingPages de chaque domaine.

Également modifié le 23 octobre 2026 (produits) :

• Nouveau : GET /v1/products et POST /v1/products/query recherchent et parcourent les produits des boutiques, chacun avec son prix, ses estimations de ventes, ses unités vendues, ses avis, son rang parmi les meilleures ventes, ses publicités Meta, sa portée et ses dépenses dans l'UE, ses pays de vente, sa date de lancement et sa boutique, triés par relevance, newest (la date de lancement), activeAds ou spend (les dépenses publicitaires dans l'UE sur les 30 derniers jours) (MCP search_products). searchType compare le texte au nom du produit ou au domaine de sa boutique, et les filtres nommés bornent le prix en USD, les publicités actives, la part des publicités, le nombre d'avis et le jour de lancement, et acceptent les devises et l'abonnement ; GET /v1/filters/products liste les devises qu'ils acceptent.
• shop (le domaine ou l'id d'une boutique) ne liste que les produits de cette boutique, sans texte de recherche à côté, dans la recherche de produits et dans search_products. Les tableaux enregistrent les produits (sourceType product) tels qu'une recherche les a affichés en dernier, et la recherche dans tout ce qui a été enregistré les retrouve par leur titre et leur boutique.
• Le serveur MCP compte 73 outils.

Également modifié le 23 octobre 2026 (filtres de produits) :

• La recherche de produits accepte d'autres filtres nommés : l'estimation des ventes d'un mois ou d'un jour (minEstMonthlySales, minEstDailySales et leurs maximums ; la borne d'un jour correspond à 30 jours de celui-ci), les unités vendues par mois ou par jour (minUnitsSoldMonthly, minUnitsSoldDaily), sellingCountries (un produit qui se vend dans l'un d'eux), shopCountries, la note des avis (minRating, maxRating), minAdsLaunched (publicités Meta lancées au cours des 30 derniers jours), minSpendShare, minEuReach (la portée UE sur 30 jours), hasPartnershipAds, promoTypes (percent-off) et minShopProductsCount, chacun avec son maximum lorsqu'il en a un ; GET /v1/filters/products liste aussi les pays des boutiques.
• sortBy accepte estSales (l'estimation des ventes), adPressure (la part des publicités) et bestSelling (le rang parmi les meilleures ventes de sa boutique, rang 1 en premier), et searchType accepte productDescription et url.
• Chaque produit a ses publicités les plus récentes (advertising.latestAds, avec leurs images dans advertising.previewUrls) et ses semaines (weeks : publicités actives, part des publicités, dépenses et portée UE par jour), et bestSeller.rankPercent est son rang exprimé en pourcentage des produits de la boutique (plus il est bas, mieux c'est).

Modifié le 24 octobre 2026 (paramètres, lectures échouées et pages profondes) :

• Un paramètre de requête qu'une route ne lit pas est refusé avec 400 validation_failed, dont le message le nomme et liste les paramètres que la route accepte, alors qu'il était auparavant ignoré sans un mot (un nom mal orthographié, ou un filtre envoyé à une route qui n'en a pas, recevait une réponse comme s'il n'avait jamais été envoyé). Les recherches refusent un filtre nommé inconnu, comme avant. Un paramètre simple (country, mediaType, active, type) qui définit un filtre que définit aussi un filtre nommé, avec une autre valeur, est refusé lui aussi.
• Suivis de marques : /ads et /timeline/metadata refusent un snapshotDate passé (ils lisent la bibliothèque publicitaire telle qu'elle est maintenant), /partnership-ads un sortBy inconnu, /v1/workspace/scaling-ads un period inconnu, et les listes de suivis un hasNewAdsSince remontant à plus de 30 jours (les compteurs de nouvelles publicités couvrent 30 jours). /v1/workspace/hooks, /ad-copies et /landing-pages lisent les lignes de chaque marque dans le sortBy et l'order demandés avant de les fusionner. Les rapports multimarques du site n'envoient euOnly qu'aux rapports qui le lisent.
• Les boutiques similaires refusent displayInTrending dans filters (la liste n'a pas d'indicateur de l'index des boutiques) et lisent leurs bornes de croissance comme des pourcentages, comme le fait une recherche de boutiques ; un offset au-delà de ce qu'une requête peut lire (600 boutiques après celles déjà lues) est refusé avec une erreur 400 qui indique jusqu'où il peut aller, et une page où la lecture s'est arrêtée a meta.partial avec un avertissement. La bibliothèque TikTok d'une boutique refuse les filtres de profil et de site (le périmètre propre à la boutique en tient lieu).
• Une partie d'une réponse que la source de données n'a pas pu lire cette fois définit meta.partial avec un avertissement (et la réponse n'est pas mise en cache), jamais une lacune silencieuse ni une liste vide ; une réponse de la source de données qui n'est pas du JSON donne une erreur 503 upstream_error, et une boutique enregistrée, un nouveau suivi ou une liste d'options d'e-mail dont la lecture échoue renvoie l'erreur, jamais not_found. Une page plus profonde que ce qu'atteint une seule lecture d'une liste qui omet des lignes a meta.partial et hasMore à true, et les textes publicitaires, les partenaires et les tests de visuels d'une marque signalent avec meta.partial lorsqu'une lecture ne couvre pas la marque.
• GET /v1/google-ads/facets/networks accepte search, limit et offset, comme les autres listes d'options. Le metric de /v1/shops/compare est obligatoire (la référence le disait facultatif).
• MCP : un outil refuse un argument que le type choisi ne lit pas (shop_report, lookup_filter_ids, market_overview, scan_advertiser) ainsi que des arguments contradictoires (trend_signal avec sort_by, active_only avec status, un argument nommé avec filters) ; creative_inspiration_pack classe ensemble les publicités de tous les mots-clés.

Également modifié le 24 octobre 2026 (recherche par image) :

• Nouveau : POST /v1/products/image-search trouve les produits des boutiques qui ressemblent à une image, chacun avec sa boutique, les plus proches en premier. Envoyez l'image en multipart/form-data : un fichier PNG, JPG ou WEBP de 10 Mo au plus (image), ou une URL d'image directe (imageUrl), que nous téléchargeons nous-mêmes. Chaque ligne est une ligne de produit telle que la renvoie la recherche de produits, avec similarity (de 0,7 à 1) et matchOnly (une correspondance dont l'index des produits n'a pas de fiche : uniquement son titre, son image, son prix, sa date de lancement et sa boutique).
• La recherche accepte les filtres nommés de la recherche de produits, sortBy (relevance, estSales, activeAds, adPressure, newest, spend, spend14d) et maxPerShop (les 1, 3, 5, 10 ou 20 correspondances les plus proches de chaque boutique), par pages de 32 au plus. GET /v1/products/image-search/{searchId} lit ses autres pages, tris, filtres et résultats par boutique sans renvoyer l'image, et GET /v1/products/image-search/history liste vos propres recherches par image récentes.
• L'image est réécrite avant d'être recherchée, au format JPEG sans ses métadonnées (EXIF, localisation, commentaires), et une URL d'image ne quitte jamais nos serveurs. Nouvelles erreurs : 400 invalid_image, 400 unsupported_url et 422 unreadable_image.
• Avec l'offre Free, la recherche par image est classée par pertinence, sans filtres. Le serveur MCP compte 67 outils : search_products_by_image est nouveau.

Modifié le 25 octobre 2026 (crédits) :

• L'API et le serveur MCP sont décomptés en crédits et non plus en requêtes : 1 crédit = 1 résultat renvoyé : les détails d'une marque, une publicité ou une ligne d'une liste. Un résultat vide est gratuit. Un appel coûte les résultats qu'il renvoie, et le quota mensuel des offres s'exprime en crédits.
• Les réponses décomptées envoient X-Usage-Cost, X-Credits-Used, X-Credits-Remaining et X-Credits-Source ; GET /v1/usage indique les crédits de recharge sous credits.topup.balance.
• 402 insufficient_credits arrive une fois que les crédits du mois et les crédits de recharge sont tous épuisés, avec details.upgradeUrl et details.topUpUrl.
• La limite de débit est partagée par tout l'espace de travail.

Les liens de partage (shareUrl) ouvrent une page web sur https://sellwinners.com que tout le monde peut consulter. La même fiche est disponible en JSON depuis /v1/shared/ads/{token} et /v1/shared/boards/{token}. Un lien dont le propriétaire est sur l'offre Free répond 403 forbidden jusqu'à ce que le propriétaire repasse sur une offre payante.

Les endpoints d'identité /v1/me, /v1/usage et /v1/workspace renvoient leurs objets au premier niveau, à côté de requestId. Les endpoints système /v1, /v1/health et /v1/system/freshness ne comportent pas de requestId, et /v1 et /v1/health renvoient un objet simple sans data. L'identifiant de requête est aussi envoyé dans l'en-tête X-Request-Id. Indiquez-le lorsque vous contactez le support.

Les tableaux, les favoris et les suivis de marques ont aussi des endpoints POST, PATCH et DELETE. Ils acceptent un corps JSON, envoyé avec Content-Type: application/json.

Pagination

Les endpoints de liste acceptent limit (jusqu'à 100 pour les recherches ; les listes de facettes acceptent jusqu'à 500 et les /snapshots d'une marque jusqu'à 365) et soit page (1, 2, 3…), soit offset. Lorsque les deux sont envoyés, c'est offset qui est utilisé. La taille de page par défaut est indiquée pour chaque endpoint. Les listes de publicités, de publicités Google, de TikTok, d'e-mails et de médias répondent avec :

"pagination": { "page": 2, "limit": 25, "total": 1840, "totalPages": 74, "hasMore": true }

Les listes de boutiques, de produits et d'annonceurs, ainsi que les publicités d'un annonceur, répondent avec :

"pagination": { "limit": 32, "offset": 32, "total": 5120, "hasMore": true }

Pour obtenir la page suivante, répétez la même requête avec page plus un, ou avec offset plus limit. Dans le corps d'un POST …/query, envoyez "page" ou "offset" comme champs. hasMore vaut false sur la dernière page. Lorsque la source de données refuse de poursuivre une recherche au-delà d'un certain point, la page qui l'atteint répond hasMore à false avec meta.partial à true et un avertissement qui indique combien de résultats peuvent être lus. La pagination atteint les 5 000 premiers résultats d'une recherche (pour une recherche d'annonceurs, ses 100 premiers). Restreignez la recherche avec des filtres ou changez le tri pour voir d'autres résultats.

Les listes de publicités Google renvoient un total exact, sauf pour une liste que la règle de statut ou de jours de diffusion restreint (voir la recherche de publicités Google). Un "totalEstimated": true signale un total (et son totalPages) qui reste une estimation tant que la liste n'a pas été lue jusqu'au bout, comme pour les boutiques similaires d'une boutique et une recherche de publicités Meta d'une boutique (websiteIds).

Les tableaux, les favoris et les rapports du suivi de marques acceptent page et limit et répondent avec page, limit, total, totalPages et hasMore. Les listes de facettes, les /products d'une boutique et ses boutiques /similar acceptent limit et offset et répondent avec limit, offset, total et hasMore.

Tri & filtres

Les endpoints de recherche acceptent sortBy et order (desc par défaut). Lorsque vous passez un terme de recherche, les résultats sont triés par relevance, sauf si vous choisissez un autre tri ; sans terme de recherche, le tri par défaut est newest (boutiques et produits : relevance, médias : reach). Les recherches de publicités Google et TikTok sont toujours classées par pertinence ; sortBy s'y applique lorsque vous parcourez sans terme de recherche.

Chaque source de données a un endpoint POST …/query qui accepte un corps JSON avec query, filters, sortBy, order, limit et page (ou offset) pour un filtrage avancé. Utilisez les endpoints de facettes pour voir les valeurs et les id qu'acceptent les filtres.

Les filtres peuvent être envoyés par leur nom : comme paramètres de requête supplémentaires sur une recherche GET (?status=active&minDaysRunning=30&mainCountries=US,GB) ou comme champs de premier niveau d'un corps POST …/query ({"status": "active", "minDaysRunning": 30}). Chaque endpoint ci-dessous liste les noms qu'il accepte. Sur les endpoints de recherche, un nom de filtre que l'endpoint ne prend pas en charge renvoie une erreur 400 validation_failed qui liste les noms pris en charge : une faute de frappe ne renvoie donc jamais en silence des résultats non filtrés ; les rapports du suivi de marques ignorent les noms qu'ils ne connaissent pas. Les listes acceptent des valeurs séparées par des virgules ou un tableau JSON, les dates s'écrivent 2026-01-31, et l'objet brut filters fonctionne toujours à côté des filtres nommés.

Les filtres de croissance (trafficGrowth, adsGrowth, pageReachGrowth, adReachGrowth) acceptent des règles écrites sous la forme {"comparison": "greater" | "lower", "value": 50} ou {"operator": "gte" | "lte", "value": 50}. Les valeurs sont des pourcentages sur les 30 derniers jours ; les autres périodes ne sont pas disponibles. minRankDelta est le nombre minimum de positions qu'une publicité a gagnées sur rankDeltaWindow (7d, sauf si vous envoyez 14d ou 30d). hideSavedAds exclut les publicités que vous avez déjà enregistrées. Les id de catégorie de chaque filtre categoryIds proviennent de /v1/facets/categories.

Limites de débit & crédits

1 crédit = 1 résultat renvoyé : les détails d'une marque, une publicité ou une ligne d'une liste. Un résultat vide est gratuit. Chaque offre inclut des crédits pour le mois, renouvelés à 00:00 UTC le 1er. Un appel coûte les résultats qu'il renvoie : un limit plus petit coûte donc moins cher, et un appel d'outil MCP coûte les résultats qu'il renvoie, comme l'API. Les crédits et la limite de débit sont propres à chaque espace de travail : toutes les personnes qui en font partie, toutes ses clés, l'API et le serveur MCP partagent une seule réserve de crédits et une seule limite de débit. Sur une offre payante, le propriétaire de l'espace de travail peut acheter des crédits de recharge sur la page de facturation (€1 donne 120, à partir de €10) : ils sont utilisés après les crédits du mois, se reportent d'un mois sur l'autre et n'expirent jamais.

Chaque réponse décomptée comporte :

X-RateLimit-Limit       requests allowed per minute
X-RateLimit-Remaining   requests left this minute
X-Usage-Cost            credits this request cost
X-Credits-Used          credits this request cost (the same number)
X-Credits-Remaining     credits left after this request (monthly and top-up)
X-Credits-Source        recurring, topup or hybrid (when it cost credits)
X-Quota-Limit           credits included this month
X-Quota-Remaining       monthly credits left
X-Quota-Reset           when the monthly credits renew (UTC)
X-Request-Id            the id of this request

Au-delà de la limite de débit par minute, vous recevez 429 rate_limited avec un en-tête Retry-After (en secondes). Lorsque les crédits du mois et les crédits de recharge sont tous épuisés, vous recevez 402 insufficient_credits, avec details.upgradeUrl et details.topUpUrl, jusqu'au renouvellement des crédits mensuels. Consultez vos crédits à tout moment avec GET /v1/account ou GET /v1/usage. Ces appels ne coûtent rien, envoient quand même X-Usage-Cost: 0, X-Credits-Used: 0 et X-Credits-Remaining, et fonctionnent même lorsque les crédits sont épuisés.

Ces limites s'appliquent à l'API et au serveur MCP, sur les offres payantes comme sur Free. L'application web du site n'est pas décomptée : sur les offres payantes, elle est illimitée dans le cadre d'un usage raisonnable.

L'offre Free

L'offre Free comprend l'application web et le serveur MCP (150 crédits par mois), sans l'API. Un compte Free crée une clé pour le serveur MCP (agents IA) dans son tableau de bord, dans la limite de 150 crédits par mois et de 10 requêtes par minute ; l'API REST fait partie des offres payantes : avec une clé Free, elle répond 403 plan_not_eligible, avec details.feature, details.requiredPlan et details.upgradeUrl, sur tous les endpoints sauf GET /v1/account, et rien n'est décompté. Une clé créée sur une offre payante est suspendue avec Free, et elle fonctionne de nouveau dès que le compte repasse sur une offre payante. Avec Free, une recherche renvoie ses premiers résultats, et un outil ou un endpoint dont Free n'inclut pas les données répond avec le message des offres payantes. La comparaison des offres montre ce qu'inclut Free. Les marques de démonstration sont accessibles en intégralité sur le site.

Erreurs

Les erreurs utilisent les codes de statut HTTP standard et un corps JSON :

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "requestId": "req_8f2c1a9b4d7e6f3a2b1c0d9e",
    "details": null
  }
}

code est stable et fiable pour aiguiller votre code, message est rédigé pour des humains, et details contient des données supplémentaires lorsqu'il y en a (les champs rejetés d'une erreur 400 ; les crédits mensuels, leur date de renouvellement, upgradeUrl et topUpUrl d'une erreur 402).

URL des médias

Les images et les vidéos des réponses sont servies depuis notre CDN à l'adresse https://api.sellwinners.com/v1/media/file/…. Ces URL ne nécessitent pas de clé API et ne consomment pas de crédits : vous pouvez donc les intégrer directement dans des balises <img> et <video>. Un fichier que la source de données n'a plus est envoyé comme null pendant une journée, et un fichier manquant répond par une erreur 404 vide de son type de média. Les images de produits et les icônes d'applications hébergées sur le CDN de Shopify sont elles aussi servies depuis notre CDN. Pour afficher une image en petit, ajoutez ?w=96 (miniatures) ou ?w=480 (cartes) : une image JPEG, PNG, WebP ou GIF est alors envoyée en WebP à cette largeur au plus, jamais agrandie ; une animation, une image plus petite ou une vidéo est envoyée telle quelle. Pour une liste à plat de visuels prêts à afficher, utilisez /v1/media.

Pour afficher une image à sa taille d'origine mais plus légère, ajoutez ?w=full : une image JPEG, PNG, WebP ou GIF est alors envoyée en WebP à sa largeur et à sa hauteur d'origine, avec une qualité visuellement identique, si cela fait gagner au moins un dixième du fichier ; sinon, et pour une animation ou une vidéo, l'original est envoyé tel quel. Sans w, le fichier d'origine est envoyé.

Découverte

Transformer un nom, un domaine ou un ID de page en ID utilisables par les autres endpoints.

curl "https://api.sellwinners.com/v1/lookup?q=allbirds.com&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/lookup/facebook-shop?shopId=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

Boutiques

Trouver des boutiques Shopify et obtenir leurs produits, trafic, ventes, réseaux sociaux et publicités.

curl "https://api.sellwinners.com/v1/shops?search=shoes&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/shops/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "mainMarketCountries": ["US"], "minMonthlyVisits": 50000, "page": 1, "search": "shoes", "sortBy": "monthlyVisits"}'

curl "https://api.sellwinners.com/v1/shops/allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/products?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/similar?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/advertisers" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/socials/history?days=90" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/sales/history?days=90" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/socials" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/tiktok" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/apps" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/pixels" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/stores" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/media-mix" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/emails?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/compare?shopIds=allbirds.com%2Con.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tools/shopify-apps?url=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tools/shopify-theme?url=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/feed" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/q4-season" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/q4-season/landing-pages" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/q4-season/creatives" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/ad-texts?kind=hook&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/landing-pages" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/landing-pages/detail?url=https%3A//www.allbirds.com/" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/advertisers/ADVERTISER_ID/landing-pages" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/ad-ranking?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/shops/allbirds.com/ad-ranking/query" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/ad-ranking/series" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/creative-testing?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/creative-testing/2026-10-19" \
  -H "X-API-Key: YOUR_API_KEY"

Marché

Les totaux quotidiens de l'ensemble du marché, et sa saison T4.

curl "https://api.sellwinners.com/v1/market/overview" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/market/q4-overview" \
  -H "X-API-Key: YOUR_API_KEY"

Publicités Meta

Visuels publicitaires Facebook et Instagram avec médias, portée et rang.

curl "https://api.sellwinners.com/v1/ads?search=skincare&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/ads/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "mainCountries": ["US"], "mediaType": "video", "minDaysRunning": 14, "page": 1, "query": "skincare", "sortBy": "reach", "status": "active"}'

curl "https://api.sellwinners.com/v1/ads/AD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/AD_ID/reach-history?limit=30" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/AD_ID/media-url" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/facets/landing-pages?scopeDomain=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/facets/ad-copies?scopeDomain=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/ads/facets/partners?scopeDomain=allbirds.com" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/ads/AD_ID/share" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/ads/AD_ID/share" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shared/ads/TOKEN" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/tools/ad-hooks" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"angle": "pain", "language": "en", "niche": "skincare", "platform": "both", "product": "Vitamin C serum"}'

curl "https://api.sellwinners.com/v1/tools/ad-hooks" \
  -H "X-API-Key: YOUR_API_KEY"

Google Ads

Visuels publicitaires Google.

curl "https://api.sellwinners.com/v1/google-ads?search=running%20shoes&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/google-ads/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "page": 1, "query": "running shoes", "status": "active"}'

curl "https://api.sellwinners.com/v1/google-ads/AD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

TikTok

Publicités et publications organiques TikTok.

curl "https://api.sellwinners.com/v1/tiktok/library?search=fitness&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/tiktok/library/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "minViews": 100000, "page": 1, "query": "fitness", "type": "ad"}'

curl "https://api.sellwinners.com/v1/tiktok/library/ITEM_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/SHOP_ID/tiktok/library?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Médias

Visuels prêts à afficher : URL d'images et de vidéos sur notre CDN.

curl "https://api.sellwinners.com/v1/media?search=sneakers&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/media/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "mediaType": "video", "page": 1, "query": "skincare", "status": "active"}'

curl "https://api.sellwinners.com/v1/media/file/FILE_KEY" \
  -H "X-API-Key: YOUR_API_KEY"

Annonceurs

Annonceurs (pages Facebook) et leur activité.

curl "https://api.sellwinners.com/v1/advertisers?search=nike&country=US&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/advertisers/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "minActiveAds": 10, "offset": 0, "query": "nike"}'

curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/history?days=90" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

E-mails

E-mails marketing et newsletters des marques.

curl "https://api.sellwinners.com/v1/emails?search=black%20friday&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/emails/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"campaignTypes": ["Marketing"], "limit": 10, "page": 1, "query": "black friday", "sentAfter": "2025-11-01"}'

curl "https://api.sellwinners.com/v1/emails/EMAIL_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/emails/EMAIL_ID/html" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shops/allbirds.com/emails/stats?month=2026-09" \
  -H "X-API-Key: YOUR_API_KEY"

Produits

Produits des boutiques avec prix, ventes, avis, publicités et portée UE.

curl "https://api.sellwinners.com/v1/products?search=serum&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/products/query" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"limit": 10, "minActiveAds": 10, "minPriceUsd": 20, "offset": 0, "query": "serum", "sortBy": "activeAds"}'

curl "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/lookup?url=https%3A//example.com/products/blue-mug" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID/ads" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/products/SHOP_ID:PRODUCT_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shared/products/TOKEN" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/facets" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/shops/image-search" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]"

curl -X POST "https://api.sellwinners.com/v1/products/image-search" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "maxPerShop=3"

curl "https://api.sellwinners.com/v1/products/image-search/history?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/products/image-search/SEARCH_ID?sortBy=activeAds&page=2" \
  -H "X-API-Key: YOUR_API_KEY"

Facettes

Les valeurs et les ID que prennent les filtres de recherche.

curl "https://api.sellwinners.com/v1/facets/categories?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/shopify-apps?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/technologies?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/pixels?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/themes?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/facets/email-classifications" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/networks" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/countries?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/formats" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/statuses" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/google-ads/facets/categories?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/categories?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/languages?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/countries?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/content-types?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/tiktok/facets/media-types?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/emails/facets/promotionTypes?limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/shops" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/advertisers" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/products" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/filters/ads" \
  -H "X-API-Key: YOUR_API_KEY"

Tableaux

Enregistrer des publicités, boutiques, produits, e-mails et annonceurs dans des tableaux, et les partager.

curl "https://api.sellwinners.com/v1/boards?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"kind": "collection", "name": "Skincare winners", "surface": "ads", "visibility": "workspace"}'

curl "https://api.sellwinners.com/v1/boards/BOARD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/boards/BOARD_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"description": "Ads worth a second look.", "name": "Skincare winners 2026"}'

curl -X DELETE "https://api.sellwinners.com/v1/boards/BOARD_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/restore" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/boards/BOARD_ID/parent" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"parentBoardId": "BOARD_ID"}'

curl "https://api.sellwinners.com/v1/boards/BOARD_ID/items?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/boards/search?q=serum&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/items" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"sourceId": "AD_ID", "sourceType": "meta_ad"}'

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/items/ITEM_ID/move" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"targetBoardId": "BOARD_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/boards/BOARD_ID/items/ITEM_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/boards/BOARD_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/boards/BOARD_ID/share-links" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/shared/boards/TOKEN" \
  -H "X-API-Key: YOUR_API_KEY"

Favoris

Publicités, boutiques et e-mails favoris, rangés dans des dossiers.

curl "https://api.sellwinners.com/v1/favorites/ads?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/ads" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"adId": "AD_ID", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/saved/FAVORITE_ID/folder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folderId": "FOLDER_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/saved/FAVORITE_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/RECORD_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/favorites/ads/folders?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/ads/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Winners", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/folders/reorder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folders": [{"id": "FOLDER_ID", "order": 0}]}'

curl -X POST "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID/visibility?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"visibility": "private"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Top performers"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/ads/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"mode": "move_items_to_root"}'

curl "https://api.sellwinners.com/v1/favorites/shops?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/shops" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"scope": "workspace", "websiteId": "SHOP_ID"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/saved/FAVORITE_ID/folder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folderId": "FOLDER_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/saved/FAVORITE_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/RECORD_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/favorites/shops/folders?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/shops/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Winners", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/folders/reorder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folders": [{"id": "FOLDER_ID", "order": 0}]}'

curl -X POST "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID/visibility?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"visibility": "private"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Top performers"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/shops/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"mode": "move_items_to_root"}'

curl "https://api.sellwinners.com/v1/favorites/emails?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/emails" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"emailId": 123456, "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/saved/FAVORITE_ID/folder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folderId": "FOLDER_ID"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/saved/FAVORITE_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/RECORD_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/favorites/emails/folders?scope=workspace&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/favorites/emails/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Winners", "scope": "workspace"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/folders/reorder?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"folders": [{"id": "FOLDER_ID", "order": 0}]}'

curl -X POST "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID/share?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID/visibility?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"visibility": "private"}'

curl -X PATCH "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Top performers"}'

curl -X DELETE "https://api.sellwinners.com/v1/favorites/emails/folders/FOLDER_ID?scope=workspace" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"mode": "move_items_to_root"}'

Vues enregistrées

Les recherches enregistrées sur les pages de liste du site, par page.

curl "https://api.sellwinners.com/v1/views" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/views" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"context": "shops", "name": "Big US shops", "state": "f.marketCountries=US\u0026f.minMonthlyVisits=100000\u0026sortBy=monthlyVisits"}'

curl -X PATCH "https://api.sellwinners.com/v1/views/VIEW_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Big US shops 2026", "position": 0}'

curl -X DELETE "https://api.sellwinners.com/v1/views/VIEW_ID" \
  -H "X-API-Key: YOUR_API_KEY"

Suivis de marques

Suivre des marques et lire des rapports sur leurs publicités, leurs visuels et leurs pages de destination.

curl "https://api.sellwinners.com/v1/brandtrackers?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/brandtrackers" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"domain": "allbirds.com"}'

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X DELETE "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/overview" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/snapshots?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/timeline?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/timeline/metadata" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/partnership-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/partnership-ads/count" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/top-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ad-rank?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/scaling-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/creatives?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/testing?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/hooks?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/transcripts?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/headlines?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ad-copies?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/landing-pages?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/landing-pages/simple?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/ad-copy-evolution?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/headline-evolution?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/landing-page-evolution?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/partners?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/media-mix" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/demography" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity/events?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity/calendar" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/activity/calendar/days" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/BRANDTRACKER_ID/time-series" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/top-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/scaling-ads?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/hooks?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/ad-copies?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/landing-pages?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/media-mix?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/brandtrackers/folders" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.sellwinners.com/v1/workspace/folders" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.sellwinners.com/v1/brandtrackers/folders" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Competitors"}'

curl -X PATCH "https://api.sellwinners.com/v1/brandtrackers/folders/FOLDER_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"name": "Direct competitors"}'

curl -X DELETE "https://api.sellwinners.com/v1/brandtrackers/folders/FOLDER_ID" \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"action": "move-to-default", "confirm": true}'