API-documentatie voor e-commercedata

De API van SellWinners geeft je e-commerce- en advertentie-inzichten via HTTPS met JSON-antwoorden: Shopify-winkels met hun producten en verkeer; winkelproducten met hun prijs, omzetschattingen, reviews en advertenties; Meta-, Google- en TikTok-advertenties; adverteerders; en de e-mails die merken versturen. Elk endpoint is ook beschikbaar voor AI-agents via onze gehoste MCP-server. Deze pagina behandelt authenticatie, het antwoordformaat, paginering, sorteren en filters, snelheidslimieten en credits, fouten en media-URL's, daarna elk endpoint met zijn parameters en een voorbeeldverzoek, en de tools van de MCP-server.

Snelstart

1. Maak een account aan, bevestig je e-mailadres en kies een betaald abonnement: daar beginnen de API en de MCP-server.
2. Open API-sleutels en maak een sleutel aan. Kopieer hem meteen: hij wordt maar één keer getoond.
3. Doe je eerste verzoek:

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);

Authenticatie

Stuur je API-sleutel bij elk verzoek mee in de header X-API-Key, of als bearer-token:

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

Sleutels beginnen met ak_live_. Houd ze geheim: zet ze niet in front-endcode of openbare repository's. Je kunt meerdere sleutels maken (één per app of omgeving) en elke sleutel intrekken vanuit je dashboard; een ingetrokken sleutel werkt meteen niet meer.

Antwoorden

Elk antwoord is JSON. Het bevat een requestId en het resultaat onder data: een lijst voor zoekopdrachten en overzichten, één object voor één record. Lijsten voegen een object pagination toe, en sommige antwoorden voegen meta toe.

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

Records zijn geneste objecten: een advertentie heeft media, advertiser, content, metrics, audience, rank en flags, en winkels, adverteerders, Google-advertenties, TikTok-items en e-mails zijn op dezelfde manier gegroepeerd. Een waarde die niet bekend is, is null. Verdere velden zonder vaste plek staan onder extra. Het voorbeeld hierboven is ingekort.

In een advertentie is content.title de kop en content.callToAction leesbare tekst zoals 'Shop now'. metrics.estimatedSpend is de uitgavenschatting van de bron als die er een heeft (een losse advertentie via /v1/ads/{adId} leest die), anders bereik x 9 / 1000 (9 USD per 1.000 bereikte mensen); een uitgavenschatting heeft twee decimalen onder 10 USD en is in hele dollars vanaf 10 USD. rank.rankDelta is de huidige rang min de vorige, dus een negatieve waarde betekent dat de advertentie is gestegen, en rank.improvementPct is een fractie (0,25 is een kwart).

De rangrapporten van de Merktracker (/ad-rank, /scaling-ads, /v1/workspace/scaling-ads en de MCP-tool get_brandtracker_scaling_ads) voegen hun eigen metrics toe: daar is metrics.rankDelta de vorige rang min de huidige (positief: gewonnen plaatsen) en metrics.improvementPct de fractie van de vorige rang die is gewonnen, zoals bij een advertentie (0,875 is 87,5%). Bij een losse advertentie worden metrics.reachDelta1d, reachDelta7d en reachDelta30d gevuld uit de bereikgeschiedenis. Winkels noemen hun categorieën: catalog.mainCategory in overzichten, plus catalog.categories bij een losse winkel.

In een Google-advertentie zijn media.type en media.format text, image of video, en media.url is de afbeelding van de advertentie: bij een videoadvertentie de miniatuur (er is geen videobestand). transparencyUrl is de advertentie in het Ads Transparency Center van Google, waar een videoadvertentie wordt afgespeeld; die is null als de advertentie geen Google-id's heeft. network is search, youtube, shopping, maps of other, en dat geldt ook voor de waarden van extra.networks.

Gewijzigd op 19 oktober 2026:

• De media.format van een Google-advertentie was een formaatcode en is nu text, image of video, de media.type kan text of video zijn, en extra.networks gebruikt de namen van network in kleine letters.
• Bij Google is media.url nooit een videobestand, ook niet als media.type gelijk is aan video.
• In het Google-filter formats betekent image nu afbeeldingsadvertenties (eerder betekende het tekstadvertenties), dus gebruik text voor tekstadvertenties. De eerdere codes static_image, html5_iframe en responsive_display, en hun korte namen, worden nog steeds geaccepteerd.

De status van een Google-advertentie is alleen active zolang Google de advertentie toont: een advertentie die Google al meer dan 7 dagen niet heeft getoond, is unknown. daysRunning telt de dagen van firstSeenAt tot lastSeenAt, beide meegerekend; extra.servedDays is de eigen telling van de databron, die doorloopt nadat een advertentie stopt. De filters stemmen overeen met wat elke advertentie toont: status=active houdt de advertenties over die Google in de laatste 7 dagen heeft getoond en status=inactive de advertenties die de databron als gestopt markeert, dus een unknown-advertentie valt onder geen van beide; minDaysRunning en maxDaysRunning houden de advertenties over waarvan daysRunning binnen de grenzen valt. Zo'n lijst heeft pagination.total null, en als weinig van de gelezen advertenties overeenkomen, eindigt hij vroeg, met meta.partial en een waarschuwing.

Zonder zoektekst toont sortBy=relevance de nieuwste; sortBy=reach accepteert alleen order=desc. Met status=active toont sortBy=reach weinig advertenties: in volgorde van bereik zijn de eerste advertenties vooral advertenties die Google niet meer toont, dus sorteer op nieuwste voor de advertenties die Google nu toont (de waarschuwing zegt dat ook). Google-advertenties accepteren geen sortBy=longestRunning: de databron rangschikt die sortering op dagen die doorlopen nadat een advertentie stopt, waardoor er advertenties werden getoond die Google niet meer toont, en de API antwoordt 400 met die reden.

extra.startIsFloor markeert een advertentie die voor het eerst is gezien op 31 mei 2018, de eerste dag van de advertentiedata van Google, dus ze kan ouder zijn. audience.countries toont elk doelgroepland, met een percentage alleen voor een advertentie die in één land is getoond; remarketing en interest zijn null als ze onbekend zijn.

Google rapporteert alleen een bereik voor een deel van de advertenties die in de EU worden getoond, vaak alleen als 10.000.000, de top van zijn schaal (10 miljoen of meer): de meeste advertenties hebben er geen, en nullReasons zegt waarom reach.value null is (not_reported: een advertentie die in de EU is getoond en waarvoor Google geen bereik rapporteert; eu_only: een advertentie die elders is getoond), behalve bij een bereik dat het abonnement weglaat. extra.networks is de lijst van de databron met de platforms van de advertentie, die network niet per se noemt. extra.shop.google bevat de Google-totalen van de website van de adverteerder; voor een site die geen winkel is (een appstore, een sociale site, een linkverkorter) zijn advertiser.domain en websiteId null.

Gewijzigd op 20 oktober 2026:

• Een domein (GET /v1/shops/{domain}, de lookup, een domain bij TikTok, de concurrentenbriefing) is de site met precies dat domein, ook buiten de winkelindex; een domein dat de databron niet bereikt, antwoordt 404.
• GET /v1/lookup rangschikt de resultaten met de beste eerst: de eigen site van een domein, de eigen Facebook-pagina's (hoofdpagina eerst), daarna de pagina's met een naam zoals het domein; voor een naam de eigen site van het merk en de eigen pagina's (hoofdpagina eerst), daarna de winkels en pagina's die op de naam zijn gevonden.
• Als de site van het merk is gevonden, wordt een winkel of pagina die de naam alleen binnen een woord heeft weggelaten, en is een site met die naam alleen exact als hij advertenties draait; anders is een naamovereenkomst alleen exact met verkeer of advertenties. Officiële pagina's met een andere naam zonder live advertentie komen na de pagina's die op naam zijn gevonden.
• De signals.activeAdsSource van een winkelrij zegt waar de activeAds vandaan komen: page (de live advertenties van de hoofdpagina, nu gelezen, in de eigen rij van de winkel) of index (de telling van de winkelindex, die ouder kan zijn).
• Een zoekopdracht op winkeldomein (searchType=domain) toont de exacte site eerst, met extra.exactDomainMatch (en extra.inShopIndex false als de winkelindex de site weglaat).
• Voor een site die geen winkel is (een appstore, een sociale site of berichtensite, een linkverkorter of een trackingredirect) is extra.domain van een adverteerdersrij null, noemt een adverteerdersrecord de site in extra.nonShopSite, laat het extra.platforms weg en haalt het linkedShops uit de landingspagina's (fromLandingPages), en heeft een advertentie geen shops.
• Datum-tijden die de databron zonder tijdzone stuurt, zijn UTC en worden nu met +00:00 verstuurd.
• In e-mailstatistieken heeft emailsByDayOfWeek als sleutel het nummer van de dag: 0 is zondag, 6 zaterdag.
• Lookup-rijen kunnen nullReasons bevatten, en een winkelrecord meta.partial als de cijfers uit het overzicht niet konden worden gelezen.

Ook gewijzigd op 20 oktober 2026 (TikTok):

• De publishedAt van een TikTok-item is UTC. Die liep 1 of 2 uur achter, waardoor een post uit de laatste uren van een UTC-dag op de volgende dag stond en daysRunning één dag te kort was.
• De filters stemmen daarmee overeen: publishedAfter en publishedBefore zijn UTC (een datum alleen is het begin van die dag, en publishedBefore toont de posts daarvoor), minDaysRunning en maxDaysRunning tellen vanaf de UTC-dag, net als daysRunning, en sortBy=longestRunning begint op 31 augustus 2016, 22:00 UTC.

Ook gewijzigd op 20 oktober 2026 (Google-advertenties):

• GET /v1/google-ads, POST /v1/google-ads/query en de MCP-tool accepteren geen sortBy=longestRunning (en ook geen daysRunning) en antwoorden 400 met de reden: de databron rangschikt die sortering op dagen die doorlopen nadat een advertentie stopt, waardoor er advertenties werden getoond die Google niet meer toont.
• Een Free-zoekopdracht waarvan status=active de eerste resultaten inkort, antwoordt met meta.partial en een waarschuwing die zegt hoeveel van de gelezen advertenties ze toont.
• In extra.shop heeft een site zonder verkeersdata geen monthlyVisits (dat was 0), komt een trafficGrowth30d alleen naast bezoeken boven 0, en laat extra.shop.google een totalReach of weeklyReach van 0 weg (nooit gerapporteerd) en, als het geen advertentie telt, de tellingen van 0.
• Een Google-advertentie die op een bord is bewaard, ziet er hetzelfde uit.

Ook gewijzigd op 20 oktober 2026 (winkels):

• In GET /v1/shops/{shopId} is advertising.summary.reach30d het EU-bereik van de laatste 30 dagen, opgeteld per datum (het was het totaal sinds het begin van de tracking, nu totalReach), is spend30d dat bereik x 9 / 1000, is extra.estimatedSpendUsd de uitgaven sinds het begin van de tracking en telt extra.adsLaunched30d de advertenties op die in de laatste 30 dagen zijn gelanceerd; ze zijn allemaal null voor een winkel zonder bereik in de EU of het VK.
• Winkelrecords, winkels in overzichten en e-mailstatistieken bevatten nullReasons, een veldpad gekoppeld aan de reden waarom het null is: not_shopify (omzet en producten worden alleen voor Shopify-winkels geschat), no_estimate, not_measured, eu_uk_only, not_linked (geen TikTok-profiel), not_on_tp, no_reviews, none_found.
• Een omzetschatting van nul naast verkochte stuks is null, in records, overzichten en de omzetgeschiedenis, waarvan period=week één punt per week heeft.
• traffic.growth30d is een fractie (-0,1543 is -15,4%), en traffic.history begint bij de eerste maand met bezoeken.
• catalog.mainCategory komt uit de categorie-id's (de meest specifieke van de hoofdtak), met catalog.categoryLeaves en productsCountCapped (25.001 is het plafond van de databron: 25.000 of meer).
• Een Trustpilot-pagina zonder review heeft als beoordeling null.
• tiktok.matchedBy is socials of handle als de TikTok-cijfers uit de sociale profielen van de winkel komen of uit een profiel dat via de handle is gevonden (een match, geen koppeling van de databron).
• advertising.mainPageActiveAds zijn de live advertenties van de hoofdpagina (de meting uit het advertentieoverzicht van die pagina, zoals de hoofdpagina in linkedAdvertisers die toont; de telling uit winkeloverzichten alleen als die meting er niet is) en linkedAdvertisers[].rank is de rang van de pagina.
• Vergelijkbare winkels laten de winkel zelf en zijn eigen sites weg, en elke pagina wordt aangevuld vanuit verder in de lijst (offset en limit tellen de lijst zonder die sites).
• Producten gesorteerd op populariteit zetten de bestsellers van de winkel eerst (meta.order).
• De e-mails en e-mailstatistieken van een winkel tellen elk campagnetype, en hun cijfers over 90 dagen zijn null als ze onbekend zijn.
• Een sortering op omzet toont één rij per Shopify-winkel (extra.sharedSalesWith), en sortBy=estMonthlySales&order=asc laat de winkels zonder schatting weg.

Ook gewijzigd op 20 oktober 2026 (winkelcijfers):

• Een sortering op omzet van GET /v1/shops leest door voorbij de domeinen die hij samenvoegt tot één rij per Shopify-winkel (hij stopte na de eerste rijen), voegt de domeinen van een winkel ook verderop in de lijst samen, en zijn pagination.total is null tot de lijst tot het einde is gelezen; sortBy=estMonthlySales&order=asc begint bij een schatting van 100 USD (minMonthlySales 100).
• Een omzetschatting onder 0,50 USD per verkocht stuk is null (no_estimate), in records, overzichten en de omzetgeschiedenis.
• traffic.monthlyVisits is null voor een site die nog niet is gemeten, en traffic.growth30d als de maand ervoor geen bezoeken had (not_measured); de growth30d van een sociaal netwerk komt uit de volgersgeschiedenis als de databron 0 of niets geeft, en 0 volgers is null (not_measured).
• Winkels in overzichten zeggen waarom catalog.productsCount en sales.unitsSold null zijn.
• extra.storeWide markeert een domein met 0 bezoeken dat de omzet van zijn winkel draagt (een gemeten 0, of een ander domein van de winkel, genoemd in extra.sharedSalesWith, heeft de bezoeken; Free laat de naam weg uit een winkelrecord).
• advertising.mainPageActiveAds zijn de live advertenties van de hoofdpagina zoals het advertentieoverzicht ervan ze leest (de telling uit winkeloverzichten alleen als die meting er niet is).
• Vergelijkbare winkels laten ook de merkwinkels van de winkel weg, en extra.similarIndexed is false voor een winkel die niet in de gelijkenisindex staat.
• catalog.mainCategory houdt het eigen label van de databron alleen als dat de naam van een categorie is.
• Een mediabestand waarnaar een antwoord linkte en dat de databron niet meer heeft, antwoordt 200 met een lege body en X-Media-Missing: true.

Ook gewijzigd op 20 oktober 2026 (adverteerders en Meta-advertenties):

• Het bereik van een adverteerder is het bereik in de EU en het VK, met de eigen vensters van de adverteerderszoekfunctie: advertising.reach30d, extra.reach14d, reach90d en totalReach zijn null voor een pagina zonder advertenties in de EU of het VK en zonder bereik, of voor een venster dat de databron niet heeft geteld, en nullReasons zegt waarom (eu_uk_only, not_measured); een pagina die binnen een venster is aangemaakt, heeft al haar bereik daarin (ze waren 0).
• In GET /v1/advertisers/{advertiserId} is het bereik het bereik dat adverteerdersoverzichten tonen (het werd 30 metingen terug gelezen, en metingen slaan dagen over), zijn de uitgavenschattingen null wanneer het bereik dat is, is extra.avgSpendUsd14d de gemiddelde dagelijkse uitgaven over 14 dagen, is extra.avgActiveAds14d het gemiddelde over 14 dagen van de live advertenties (het waren de nieuwe advertenties van 14 dagen), waar de databron het niet heeft berekend, voor een pagina die binnen de 14 dagen is aangemaakt, berekend uit de live advertenties die sinds haar eerste dag zijn gelezen (extra.averagedFrom), anders null, en tellen de aantallen nieuwe advertenties van een pagina die binnen het venster is aangemaakt al haar advertenties mee.
• advertising.countryDistribution is het aandeel van de live advertenties dat op elk land is gericht (een advertentie richt zich op meerdere landen), extra.reachCountries bevat het aandeel van elk land in het EU-bereik, extra.platforms.meta bevat de eigen advertenties van de pagina (het bevatte die van de hoofdpagina van de winkel), een TikTok- of Google-telling zonder cijfer wordt weggelaten, extra.mainLandingPages valt terug op de preview van de landingspagina's van een nieuwe pagina, en de lastAds van een pagina waarvan de advertentiezoekfunctie de advertenties nog niet heeft opgenomen, zijn de nieuwste die de adverteerdersrij toont, met meta.indexing, zoals bij GET /v1/advertisers/{advertiser_id}/ads (met meta.liveAds).
• Nieuw: GET /v1/advertisers/{advertiserId}/history, de live advertenties van de pagina en het EU-bereik dat ze heeft gewonnen, dag voor dag.
• Een Instagram-volgersaantal van 0 is null (de databron schrijft 0 voor een pagina zonder account dat ze kent).
• De metrics.reach en de uitgaven van een Meta-advertentie zijn null voor een advertentie die niet in de EU of het VK is getoond (eu_uk_only; ze waren 0 of null) en voor een EU-advertentie waarvan het bereik nog niet is geteld (not_measured; het was 0), waarbij mediarijen de reden geven in nullReasons.reach, media.type is carousel voor een advertentie met meer dan één afbeelding of video, en extra.startIsFloor markeert een advertentie die is gestart op 1 januari 2018, de eerste dag van de Meta-advertentiedata van de databron.
• sortBy=adRank toont de beste rang (1) eerst, ongeacht de volgorde.
• Eén advertentie (GET /v1/ads/{adId}) neemt het nieuwste bereik dat de databron rapporteert en de uitgaven daarvan, telt de bereikdelta's per datum zolang de bereikgeschiedenis actueel is (anders zijn ze null), toont de afbeeldingen en video's zoals de zoekrij dat doet, vult advertiser.reach30d en pageAnalytics.instagramFollowersHistory, voegt pageAnalytics.reachHistory toe (dezelfde reeks als impressionsHistory), en geeft de naam van een winkel die het record alleen met zijn id aanduidt (met traffic null en nullReasons shops.traffic als de site niet is gemeten); audience.gender, ageMin, ageMax en metrics.aggregatedReach zijn altijd null, omdat de databron ze niet voor één advertentie rapporteert.
• In een adverteerderszoekopdracht rangschikt sortBy=reach op het totale bereik sinds het begin van de tracking en newAds op de nieuwe advertenties van 14 dagen.
• De targeting van een Meta-advertentie zegt waarom het bereik null is: eu_uk_only alleen voor een advertentie die zich op geen enkel land in de EU of het VK richt; een advertentie die zich op zo'n land richt, of waarvan de targeting nog niet bekend is, is not_measured in de eerste 7 dagen en not_reported daarna (ze waren eu_uk_only), in advertentieoverzichten, mediarijen en bij één advertentie.
• Eén advertentie leest haar bereik- en uitgavengeschiedenis als één reeks, één meting per dag (ook de delta's), en neemt de laatste meting en de uitgaven van die reeks als het bereik van het record meer dan twee keer zo groot is en de reeks doorloopt tot de laatste dag van de advertentie; haar media valt terug op het eerste vermelde bestand, en advertiser.totalReach op het EU-bereik uit de paginadetails.
• Een adverteerdersrecord waarvan de rij geen bereik leest naast paginadetails die wel bereik lezen, krijgt het bereik uit die details (extra.totalReach, de uitgaven daarvan, advertising.reach30d daarop geteld), de aandelen in extra.reachCountries worden nooit naar 0 afgerond, extra.averagedFrom ligt nooit vóór de dag waarop de pagina is aangemaakt, en de dagelijkse geschiedenis (extra.history, GET /v1/advertisers/{advertiserId}/history) laat de metingen weg die de databron heeft gemist (een reeks nullen van 14 dagen of minder tussen metingen boven 0).
• Eén advertentie die de meting van haar reeks neemt, bewaart het bereik van het record in extra.recordReach (het cijfer dat advertentieoverzichten tonen); in een adverteerderszoekopdracht krijgt een rij die geen EU-bereik leest naast paginadetails die wel bereik lezen het bereik uit die details, net als het record; en GET /v1/advertisers/{advertiserId}/history bewaart de metingen van 0 van een pagina die nu geen EU-advertentie heeft en vóór de gevraagde dagen bereik won (ze won er geen; ze werden weggelaten als not_measured).
• Bij Free zegt een advertentie waarvan het bereik onbekend is waarom, net als bij betaalde abonnementen; alleen een bereik dat het abonnement weglaat, heeft geen reden.

Ook gewijzigd op 20 oktober 2026 (uitgavenschattingen):

• Geschatte uitgaven onder 10 USD houden twee decimalen: een bereik van 140 tegen 9 USD per 1.000 bereikte mensen is 1,26 (het was 1), en een daggemiddelde houdt zijn eigen centen; vanaf 10 USD is een uitgavenschatting in hele dollars (een bereik van 2.000 is 18).
• Dit geldt voor extra.estimatedSpendUsd en extra.avgSpendUsd14d van het adverteerdersrecord, advertising.summary.spend30d en extra.estimatedSpendUsd van een winkel, metrics.estimatedSpend van een Meta-advertentie, en statistics.euData.estimatedSpend30d van een merktracker en de estimatedSpend van elk punt van /time-series (beide hadden bij elk bedrag twee decimalen), in de API en de MCP-tools gelijk. Waar het eigen cijfer van de databron die schatting in hele dollars is, houdt het zijn centen op dezelfde manier.

Ook gewijzigd op 20 oktober 2026 (bereik van adverteerders en dagelijkse geschiedenis):

• GET /v1/advertisers/{advertiserId} voegt extra.reachScope toe: outside_eu_uk voor een pagina waarvan het meeste bereik per land buiten de EU en het VK is gezien (de databron rapporteert ook het bereik van sommige advertenties die elders zijn getoond; het bereik en de schattingen die daarop zijn gebaseerd, zijn dan dat bereik, geen EU-bereik), anders eu_uk. De extra.avgSpendUsd14d van een pagina die binnen de 14 dagen is aangemaakt, is haar uitgaven gedeeld door de volle dagen sinds de aanmaak (minstens één; het was het bereik van 14 dagen gedeeld door 14 dagen waar de adverteerdersrij er een had).
• De extra.history van het adverteerdersrecord en GET /v1/advertisers/{advertiserId}/history beginnen op de dag dat de pagina is aangemaakt; extra.history.newAds laat de 0 weg van de dagen die de databron heeft gemist, extra.followersHistory en de likes en volgers in de pageAnalytics van een advertentie laten een 0 weg tussen twee metingen boven 0 of van zo'n dag, en de dagelijkse uitgavenschattingen houden twee decimalen onder 10 USD.
• Een pagina waarvan nog geen lijst de live advertenties bevat, heeft meta.indexing in haar record, en een lege eerste pagina van GET /v1/advertisers/{advertiser_id}/ads met meta.indexing en meta.liveAds.
• Eén advertentie (GET /v1/ads/{adId}): extra.spendHistory begint op de dag dat de advertentie is gestart, elke spendUsd met twee decimalen onder 10 USD; advertiser.totalReach ligt nooit onder de laatste meting van pageAnalytics.reachHistory (extra.pageRecordReach bevat dan het totaal van het record, het totaal dat adverteerdersoverzichten tonen); extra.recordSpend zijn de uitgaven van extra.recordReach; extra.reachScope en extra.pageReachScope zeggen waar het meeste bereik van de advertentie en van haar pagina is gezien.

Ook gewijzigd op 20 oktober 2026 (merktrackers):

• In GET /v1/brandtrackers en GET /v1/brandtrackers/{id} wordt een 0 bij advertising.newAdsLastDay naast lanceringen in de laatste 7 dagen gecontroleerd aan de hand van de lanceringen van de winkel van gisteren: hun aantal, of null (not_measured) als er geen meting van die dag is; een overzicht controleert maximaal 20 merken per aanroep, die van de gevraagde pagina.
• In /top-ads en /v1/workspace/top-ads is metrics.totalReach het EU-bereik van de advertentie: null voor een advertentie die buiten de EU en het VK is getoond (eu_uk_only) of een EU-advertentie die nog niet is geteld (not_measured), met nullReasons, en als laatste in een sortering op bereik (het was 0).
• /testing telt de bereikstatistieken over de advertenties waarvan het bereik bekend is, met nullReasons stats.reach voor een batch zonder zulke advertenties.
• In /hooks, /transcripts, /landing-pages en de hooks en landingspagina's van de werkruimte is een totalImpressions van 0 null met de nieuwe reden no_eu_reach (geen bereik in de EU of het VK geteld voor de advertenties; not_measured met euOnly), als laatste in de sortering.
• In /ad-rank, /scaling-ads en /v1/workspace/scaling-ads tellen metrics.previousRank en rankDelta, als de ranggeschiedenis van een advertentie binnen een venster van 14 of 30 dagen begint, vanaf de oudste meting daarbinnen: metrics.since is die dag en meta.windowNote zegt dat, en een cijfer dat niet kan worden gegeven, is null met nullReasons.
• In /partners is isOwnPage true voor de hoofdpagina van de winkel, de officiële pagina's met een naam zoals het merk en een pagina met de naam van het merk (creators kunnen ook als officieel worden gerangschikt), en een null-bereik of null-uitgaven hebben nullReasons.
• De eerste pagina van /ads met adCopyHashes heeft meta.latestAdDate en dataFreshnessLagDays, en met status=active ook meta.stoppedCount.
• /demography is de doelgroep in de EU en het VK, en een land onder een tienduizendste van het grootste land verhuist van countryDistribution naar otherCountries.
• /ad-copy-evolution en /headline-evolution hebben een punt voor elke vastgelegde dag (0 als de tekst niet is gebruikt, null op een dag die is afgekapt bij de teksten die worden bewaard), rangschikken teksten op de nieuwste dag en laten de dagen weg die de databron verkeerd heeft gelezen (live advertenties onder een tiende van de dagen eromheen, één dag of 2 of 3 op rij, of veel minder teksten dan de dagen aan beide kanten), zoals meta.periodNote zegt; meta.recordedDays telt de dagen. Wekelijkse en maandelijkse live advertenties in /time-series laten ook 2 of 3 zulke metingen op rij weg.

Ook gewijzigd op 20 oktober 2026 (rapporten van merktrackers, lookup en Google-bereik):

• In /ad-rank, /scaling-ads en /v1/workspace/scaling-ads komt elke rang van een rij uit de ranggeschiedenis van de advertentie: metrics.currentRank is de meting van de dag waarop de rang van de advertentiebibliotheek is gelezen (de rang die /top-ads toont; de bibliotheek kan een dag achterlopen op de geschiedenis), anders de nieuwste meting, de trajectory eindigt op die dag, en zonder meting op de dag dat het venster begint, telt de oudste meting daarbinnen (de eigen verandering van de databron over het venster wordt niet meer gebruikt).
• De eerste 50 advertenties van de advertentiebibliotheek (10 per merk over meerdere merken) worden opnieuw gerangschikt op deze cijfers: een advertentie die volgens deze cijfers minder won dan minRankDelta, of lager staat dan maxCurrentRank, wordt weggelaten (een advertentie waarvan de ranggeschiedenis geen winst geeft, volgens de eigen telling van de advertentiebibliotheek), pagination dekt de bewaarde advertenties en meta.rankNote zegt wat er is gelezen en weggelaten, ook over meerdere merken.
• Een dagelijkse /time-series (en de graph van het overzicht) is null op een dag waarvan de databron de live advertenties verkeerd heeft gelezen (onder een tiende van de dagen aan beide kanten; de nieuwste dag blijft zoals gelezen, ook in de tekstevoluties), net als de lanceringen van die dag, en dat geldt ook voor de lanceringen van de dag erna als die bijna al zijn live advertenties zijn; weken en maanden laten die lanceringen weg, en leftOut toont de dagen. /landing-page-evolution laat die dagen weg uit elke pagina, en ook de eigen meting van een pagina onder een tiende van de metingen aan beide kanten, zoals de meta.periodNote zegt, met de dag die de geschiedenis bereikt als die achterloopt.
• Een /testing-batch zonder geteld bereik heeft nullReasons stats.reach no_eu_reach, tenzij een van de advertenties nog niet is geteld (not_measured) of alle advertenties buiten de EU en het VK zijn getoond (eu_uk_only); het ontbrekende bereik en de ontbrekende uitgaven van een /partners-rij zijn alleen not_measured in de 7 dagen na de launchDate, en daarna no_eu_reach.
• /creatives noemt een advertentie met meerdere afbeeldingen of video's carousel (het was unknown).
• In GET /v1/lookup is signals.monthlyVisits van een winkel null voor een site die nog niet is gemeten (nullReasons not_measured; het was 0), zijn de live advertenties van de exacte winkelrij (bij elk type, ook shop) die van de hoofdpagina zoals het advertentieoverzicht ze leest, de mainPageActiveAds, en lezen de rijen van de eigen pagina's van de winkel de hunne op dezelfde manier, is signals.monthlyVisits van een gevolgd merk (en de totalTraffic in GET /v1/brandtrackers) null voor een site die nog niet is gemeten en zegt het waarom het ontbreekt (not_measured, of no_shop voor een pagina zonder winkel), en houdt bij Free het bereik van een pagina dat geen enkel abonnement heeft zijn reden (eu_uk_only, not_measured), ook in adverteerdersoverzichten.
• Als reach.value van een Google-advertentie null is, heeft die nullReasons (not_reported, eu_only), behalve bij een bereik dat het abonnement weglaat.
• In GET /v1/shops/{shopId} zijn advertising.mainPageActiveAds de live advertenties van de hoofdpagina zoals het advertentieoverzicht ze leest, de telling die de hoofdpagina in linkedAdvertisers toont (het was de telling van de winkelindex, die een dag ouder kan zijn).

Ook gewijzigd op 20 oktober 2026 (TikTok en e-mails):

• De metrics.engagementRate van een TikTok-rij is (likes + reacties + shares + saves) / weergaven als fractie (0,0513 is 5,13%; zoekopdrachten stuurden een percentage en GET /v1/tiktok/library/{itemId} een andere maatstaf), en daysRunning is het aantal dagen sinds de post is gepubliceerd, in beide.
• metrics.rank is de rang van de post onder de posts van de creator (1 is de beste).
• profile.followers is null als de databron de volgers niet heeft geteld (ze stuurde 0), content.category is null voor de verzamelcategorie All, en content.hashtags zijn de tags van de post, elk één keer, gespeld zoals in de beschrijving en zonder de leestekens erna (die van een record zijn de lijst van de databron, die van een zoekrij die uit de beschrijving).
• Een TikTok-record voegt profile.adsCount, organicCount en avgPostsPerWeek90d toe, vult profile.pageCreation, en heeft links null voor een rij van de databron zonder TikTok erachter (een id van minder dan 15 cijfers, of gepubliceerd vóór 31 augustus 2016, 22:00 UTC).
• sortBy=longestRunning begint bij de eerste TikToks (31 augustus 2016, 22:00 UTC).
• Een e-mailrecord noemt het actietype, de categorie en het evenement, en de bezoeken per maand, live advertenties, producten en cijfers over 90 dagen van de winkel zijn die welke de e-mailoverzichten tonen, net als de cijfers in last90Days van de e-mailstatistieken.
• Een e-mailrij laat extra.shopActiveAds weg bij een 0 zonder advertentietotaal (de nullReasons zeggen not_measured), en de shop.marketing.activeAds van een e-mailrecord is dan null; als de cijfers van de winkel niet konden worden gelezen, heeft het record meta.partial, een waarschuwing en nullReasons failed voor die cijfers.
• In de MCP-tool analyze_shop_emails rangschikt dominant campagnetypes, categorieën, actietypes en evenementen elk afzonderlijk en laat het No Promotion en No Event weg.

Gewijzigd op 21 oktober 2026:

• De metrics.views van een TikTok-item, en de likes en saves die daarnaast 0 lezen, zijn null met nullReasons not_measured (net als engagementRate) als de databron 0 weergaven stuurde naast likes, reacties, shares of saves boven 0, in zoekopdrachten en in GET /v1/tiktok/library/{itemId}; sortBy=views of likes met order=asc toont de posts waarvan de weergaven zijn geteld (minViews 1).
• Een zoekopdracht naar Meta-advertenties met websiteIds toont de eigen advertenties van de winkels: elke advertentie van de hoofdpagina van een winkel en van de officiële pagina's met een naam zoals de winkel, en de advertenties van de andere pagina's (creators, uitgevers en partners die advertenties voor de winkel draaiden) die naar de winkel of naar een site op zijn domein linken; tot de lijst tot het einde is gelezen, is pagination.total van de zoekopdracht dan het aantal advertenties van de doorzochte eigen pagina's van de winkel, een schatting (pagination.totalEstimated true), of null als de zoekopdracht geen van de eigen pagina's noemt.
• Met sortBy=longestRunning wordt elke batch advertenties die uit de databron is gelezen, op volgorde van daysRunning gezet.
• In GET /v1/shops/{shopId} telt advertising.activeAds de live advertenties van de eigen pagina's van de winkel (linkedAdvertisers[].isOwnPage), en in /products heeft een gerangschikte bestseller de titel, prijs en afbeelding van catalog.bestSellers (de prijs van een bestseller kan de laagste van zijn varianten zijn).
• De traffic.monthlyVisits (en growth30d) van een winkel is null met not_measured als die 0 leest omdat de geschiedenis naar 0 ging naast een omzetschatting boven 0 en verkochte stuks, in records, winkels in overzichten, vergelijkbare winkels en de lookup; zo'n domein is nog steeds extra.storeWide.
• In GET /v1/ads/{adId} is advertiser.totalReach de laatste meting van pageAnalytics.reachHistory zolang die meting hoogstens 2 dagen oud is (extra.pageRecordReach bevat dan het totaal van het record), wordt extra.advertiserTotalAds gevuld uit de cijfers van de pagina in overzichten (not_measured als die er niet zijn), is de bereikwinst over 7 en 30 dagen van een advertentie die binnen het venster is gestart al haar bereik, en is een winst die lager is dan die over minder dagen null (not_measured).
• De statistics.ctaCount van een merktracker noemt elke call-to-action zoals content.callToAction dat doet ('Shop now').

Ook gewijzigd op 21 oktober 2026 (winkels):

• In GET /v1/shops/{shopId} is advertising.history de live advertenties van de hoofdpagina per dag bij elk abonnement (bij Free telde het die van elke pagina), en de docs zeggen dat het bereik en de uitgaven in advertising.summary, extra.adsLaunched30d, extra.totalAds en extra.estimatedSpendUsd elke pagina van de winkel dekken, terwijl advertising.activeAds de eigen pagina's telt.
• Een catalog.productsCount van 0 van een winkel zonder vermeld product, naast bezoeken, een omzetschatting of verkochte stuks, is null met not_measured, in records, winkels in overzichten en de meta.productsCount van GET /v1/shops/{shopId}/products; sortBy=productsCount laat die winkels weg, en stuurt met order=asc minProductsCount 1 mee, tenzij er een minimum voor producten is opgegeven.
• Een zoekopdracht naar Meta-advertenties van een winkel, beperkt tot pagina's die niet van de winkel zelf zijn (trackedPages), die vroeg eindigt, zegt waarom in meta.warnings, zonder te vragen om de zoekopdracht te beperken.
• GET /v1/filters/shops meldt in meta.warnings wanneer de databron geen waarden toont, en noemt de lijsten die ze wel geven.

Ook gewijzigd op 21 oktober 2026 (paginering, e-mails en advertentielijsten):

• Pagineren door een adverteerderszoekopdracht mislukt niet meer als de databron die niet voortzet (die antwoordde 503, en opnieuw proberen hielp niet): de eerste 100 resultaten worden in één aanroep gelezen, en de pagina die het einde bereikt van wat kan worden gelezen, antwoordt hasMore false, met meta.partial true en een waarschuwing die zegt hoe ver de zoekopdracht leest.
• Een pagina die voorbij de exacte total van een zoekopdracht begint, is leeg, met hasMore false.
• Een TikTok-zoekopdracht gesorteerd op views of likes met order=asc begint bij de eerste TikToks (31 augustus 2016, 22:00 UTC), net als longestRunning, en de metrics.views (en engagementRate) van een TikTok-item is null met not_measured als die minder weergaven leest dan likes.
• De content.bodyPreview en bodyLength van een e-mail, en de content.body van een record, zijn null met not_measured waar de databron haar placeholder stuurde voor een body die ze niet heeft gelezen.
• Datum-tijden die de databron in UTC geeft, worden in lijsten en records op dezelfde manier geschreven, met +00:00 en zonder nullen aan het eind van de fractie van een seconde (2026-09-30T00:20:11.507+00:00; de tijden waarop je eigen borden, favorieten, merktrackers en deellinks zijn gemaakt of gewijzigd, eindigen op Z, zoals voorheen), en e-mailrijen bevatten de id's van hun categorie, actietype en evenement, net als het record van de e-mail.
• Elke gepagineerde lijst antwoordt pagination.hasMore, en GET /v1/google-ads/facets/countries antwoordt met een object pagination.
• Een verzoekbody die geen geldige JSON is, antwoordt 400 validation_failed met het bericht 'The request body is not valid JSON.' en details.position, het teken waar de body afbreekt.
• In Meta-advertentielijsten is het bereik van een rij de meting van de advertentie-index, die een dag kan achterlopen op het record van de advertentie, en de bereikwinsten zijn null naast een bekend bereik als de databron er geen toont (not_measured), behalve over een venster waarin de advertentie is gestart, waar ze al het bereik heeft gewonnen dat haar rij leest; in GET /v1/ads/{adId} heeft een winst die null is naast een bekend bereik ook not_measured.

Gewijzigd op 22 oktober 2026 (het Free-abonnement):

• De API en de MCP-server zijn naar betaalde abonnementen verhuisd: een sleutel van een account op het Free-abonnement antwoordde 403 plan_not_eligible op elk endpoint behalve GET /v1/account, met details.upgradeUrl, en er werd niets geteld. Op Free kon geen sleutel worden gemaakt.
• Het Free-abonnement is sindsdien veranderd: Het Free-abonnement zegt wat het nu omvat.
• Een sleutel die op een betaald abonnement is gemaakt, blijft bewaard en werkt weer zodra het account terug is op een betaald abonnement. Deellinks die door een account op Free zijn gemaakt, worden op dezelfde manier gepauzeerd.

Ook gewijzigd op 22 oktober 2026 (winkelrapporten en records):

• In GET /v1/shops/{shopId}/ad-ranking/series is rankDelta de eindrang min de beginrang (negatief als de advertentie is gestegen, zoals bij elke advertentie; het waren de gewonnen plaatsen) en heet improvementPercent nu improvementPct, een fractie; elke rij van /ad-ranking bevat dezelfde twee cijfers over het venster van de ranking in rank.
• In /activity/calendar van een gevolgd merk, een kalenderdag en /activity/calendar/days is meta.partial true of false, noemt meta.partialSources de bronnen die gedeeltelijk zijn gelezen (bij /calendar en een dag), en zijn previewtijden UTC, ook die van een TikTok-post.
• In GET /v1/shops/{shopId}/landing-pages/detail valt activeAds terug op de advertenties van de pagina, is shareOfAds linkedAdsTotal gedeeld door shopActiveAds, telt snapshots de dagen waarop de pagina is vastgelegd, zijn lifetimeAds en impressions verdwenen (de impressies waren opnieuw het bereik), is een bereik van 0 null met nullReasons.reach no_eu_reach, en hebben linkedAds de velden van de rijen van een advertentiezoekopdracht.
• De /feed van een winkel toont de eigen Meta-advertenties, net als de advertentiezoekopdrachten van de winkel.
• GET /v1/market/q4-overview accepteert elke from en to binnen het seizoen.
• In /q4-season toont winners de sleutel van elke actie met de creatives, en de URL's van landingspagina's bevatten hun protocol.
• De Shopify-detectors lezen een winkel op zijn domein zonder www..
• GET /v1/advertisers/{advertiserId} en de landingspagina's, doelgroep en mediamix van een gevolgd merk geven een eerdere dag terug in meta.snapshotDate.
• Als de Meta-advertentiestatistieken van een winkel op dat moment niet kunnen worden gelezen, antwoordt GET /v1/shops/{shopId} met meta.partial true en een waarschuwing: het bereik, de uitgavenschattingen die daarop zijn gebaseerd en de media- en formaatmix zijn null met nullReasons failed, de advertenties per land worden geteld zoals de zoekrij ze geeft, en het antwoord wordt niet bewaard, zodat de volgende aanroep ze opnieuw leest (de concurrentenbriefing bevat dezelfde meta.partial en waarschuwingen).
• Een landingspagina op het eigen domein van de winkel, of op een subdomein daarvan, is toShop true in /v1/shops/{shopId}/advertisers en /advertisers/{advertiserId}/landing-pages; als de domeinen van de winkel dat domein weglaten, zet meta.domains het als eerste op basis van de landingspagina's van de pagina's (fromLandingPages true, een ondergrens), en is de shopAds van een pagina nooit minder dan de live advertenties van haar landingspagina's op de winkel (shopAdsAtLeast true als het is verhoogd).
• In GET /v1/tiktok/library/{itemId} is profile.latestPosts[].mediaUrl de video van de post, of null met nullReasons not_reported (het was de omslagafbeelding).
• Een adverteerderszoekopdracht leest de eerste 100 resultaten en zegt dat hij eindigt op de pagina die het 100e resultaat bereikt (hasMore false en de waarschuwing), niet op de lege pagina daarna.
• Een TikTok-zoekopdracht gesorteerd op views of likes met order=asc laat nu de posts weg waarvan de weergaven niet zijn geteld (minder weergaven dan likes), en de pagination.total is een schatting (totalEstimated) tot de lijst tot het einde is gelezen; elke andere volgorde toont ze, met weergaven null.

Ook gewijzigd op 22 oktober 2026 (bewaarde items en advertentiehooks):

• Nieuw: GET /v1/boards/search vindt wat je hebt bewaard, over al je borden en je favorieten, op de woorden van wat elke bewaarde kopie toont (elk woord moet voorkomen, in willekeurige volgorde; hoofdletters en accenten worden genegeerd), op het id of op de naam van het bord, en accepteert sourceType, boardId, savedFrom en savedTo; het leest alleen je bewaarde items, nooit de databron (MCP find_saved_items).
• Nieuw: POST /v1/tools/ad-hooks schrijft drie korte openingszinnen voor een advertentie van je product, en GET /v1/tools/ad-hooks geeft je tegoed: geen maandlimiet bij betaalde abonnementen, en een limiet per minuut (429 met Retry-After); het tegoed opvragen wordt niet geteld (MCP write_ad_hooks).
• De MCP-server heeft 64 tools.

Ook gewijzigd op 23 oktober 2026 (bewaarde weergaven en winkelfilters):

• Nieuw: GET /v1/views toont de zoekopdrachten die je op de lijstpagina's van de website hebt bewaard, elk met de zoekopdracht die ze uitvoert (request: de zoekopdracht, searchType, sortBy, order en benoemde filters, zoals de zoekendpoints ze accepteren); POST /v1/views bewaart er een, PATCH /v1/views/{viewId} hernoemt, verplaatst of wijzigt er een en DELETE /v1/views/{viewId} verwijdert er een. Ze lezen en schrijven alleen je eigen weergaven, nooit de databron (MCP list_saved_views).
• Winkelzoekopdrachten accepteren excludeCurrencies (valutacodes zoals EUR), socialNetworks (instagram of tiktok: een winkel met een van beide) en shopifyPlan (headless). trafficGrowth leest ook 90 dagen (min90, max90) en adsGrowth 7 dagen (min7, max7), of de period van een regel (last90d, last7d); min en max blijven de laatste 30 dagen.
• De MCP-server heeft 65 tools.

Ook gewijzigd op 23 oktober 2026 (productlinks):

• In GET /v1/shops/{shopId} bevat elk item van catalog.bestSellers handle en productUrl, de pagina van het product op de eigen site van de winkel: het adres dat de databron geeft als dat op het domein van de winkel staat (of op een subdomein daarvan) of op het myshopify-domein, anders https://<domain>/products/<handle> als de handle bekend is, anders null.
• In GET /v1/shops/{shopId}/products volgt productUrl dezelfde regel, dus een adres op een andere site wordt niet meer gegeven, en handle is null als het niet één enkel deel van een adres is.

Ook gewijzigd op 23 oktober 2026 (winkelrijen, vergelijkbare winkels en producten):

• De createdAt van een winkel (het winkelrecord, winkelrijen en vergelijkbare winkels) is alleen de aanmaakdatum van een Shopify-winkel. Voor een site buiten Shopify geeft de databron de dag waarop ze de site begon te volgen, niet de aanmaak: createdAt is nu null (nullReasons tracking_date) en die dag is de nieuwe trackedSince. Een datum op of vóór 1 januari 2000 is de placeholder van de databron en is null (not_reported).
• De catalog.bestSellers van winkelrijen bevatten handle, productUrl (volgens de regel van het winkelrecord) en rank (1 is de bestseller), en rijen bevatten profile.isHeadless en catalog.myShopifyDomain, net als het winkelrecord.
• De googleAds.reach.value van een winkelrij is null: winkelrijen bevatten geen Google-bereik, dat in het winkelrecord staat (extra.googleAds.reach).
• Vergelijkbare winkels (GET /v1/shops/{shopId}/similar, de similarShops van het record) behouden hun extra (logo, Trustpilot, omzetgeschiedenis). Een lijst met vergelijkbare winkels die de databron vóór het einde stopt, antwoordt met meta.partial en een waarschuwing op de pagina die dat punt bereikt.
• In GET /v1/shops/{shopId}/products waren createdAt en publishedAt de eigen klok van de winkel, verstuurd als UTC (8 uur te vroeg voor een winkel op Amerikaanse Pacifische tijd). Ze zijn nu UTC, met de nieuwe updatedAt, op basis van de afwijking van de winkel ten opzichte van UTC (meta.shopUtcOffset, zoals -08:00). Als er geen afwijking kan worden gelezen, zijn de drie null (local_time) en geven createdAtLocal, publishedAtLocal en updatedAtLocal de klok van de winkel, zonder tijdzone.
• Een product dat alleen tussen de bestsellers in de winkeldetails staat, heeft publishedAt en updatedAt null (not_reported): die van de databron waren kopieën van de aanmaaktijd.
• Elk product zegt in welke lijsten het staat (lists: bestSellers, newest) en wat zijn plaats is onder de bestverkopende producten (listPosition, 1 tot 100).

Ook gewijzigd op 23 oktober 2026 (winkelrecords):

• In GET /v1/shops/{shopId} was extra.googleAds.reach.value altijd null: het is nu het Google-bereik van de winkel in de EU, met lowerBound en upperBound, en extra.googleAds voegt reachHistory, history (de Google-advertenties die per week als actief zijn gemarkeerd), updatedAt en latestAds toe.
• De growth30d van een sociaal netwerk is nu de verandering over 30 dagen uit het volgersoverzicht (het was een ander venster voor sommige Facebook-pagina's: 0,3636 waar de verandering 0,2898 was). GET /v1/shops/{shopId}/socials geeft het ook als growth30d.
• Het X-profiel van de winkel is socials.x. socials.twitter heet nu socials.x en blijft nog één release bestaan, als hetzelfde object. Elk netwerk heeft url, en socials.others toont de andere links van de winkel.
• tiktok.profileMetrics.percentAds is een percentage (0 tot 100); de nieuwe adsShare is hetzelfde als fractie. tiktok voegt avatarUrl, history, postsChange30d, postsChange30dPct en latestAds toe, en tiktok.activity.avgActiveAds7d en avgActiveAds30d, voorheen null, middelen de TikTok-advertenties per dag.
• Nieuw bij betaalde abonnementen: advertising.summary.firstAdSeenAt, longestRunningDays, medianRunningDays, landingPagesCount en de veranderingen over 30 dagen van de live advertenties, de gelanceerde advertenties en het EU-bereik (activeAdsChange30d, launchedChange30d, reachChange30d, elk ook als fractie, …Pct), en advertising.runningDaysMix, reachCountries, reachHistory, topLandingPages, adsByAgeRange en adsByGender. Bij elk abonnement: advertising.allPagesHistory en advertising.topCountries[].ads.
• Nieuw: catalog.bestSellers[].rank, sales.hasSubscription, technology.apps[].appStoreUrl en categories, profile.isHeadless, extra.updatedAt, en de createdAt en trackedSince van de winkeldatums hierboven.
• GET /v1/shops/{shopId}/advertisers voegt per pagina logoUrl en moreLandingPages toe, een profileUrl waar het advertentieoverzicht er geen heeft, en per domein landingPagesCount en moreLandingPages.

Ook gewijzigd op 23 oktober 2026 (producten):

• Nieuw: GET /v1/products en POST /v1/products/query doorzoeken en doorbladeren winkelproducten, elk met de prijs, omzetschattingen, verkochte stuks, reviews, bestsellerrang, Meta-advertenties, EU-bereik en uitgaven, verkooplanden, lanceerdatum en winkel, gesorteerd op relevance, newest (de lanceerdatum), activeAds of spend (advertentie-uitgaven in de EU over de laatste 30 dagen) (MCP search_products). searchType vergelijkt de tekst met de naam van het product of het domein van de winkel, en de benoemde filters begrenzen de prijs in USD, de actieve advertenties, het advertentieaandeel, het aantal reviews en de lanceerdag, en accepteren valuta's en of een product een abonnement is; GET /v1/filters/products toont de valuta's die ze accepteren.
• shop (het domein of id van één winkel) toont alleen de producten van die winkel, zonder zoektekst ernaast, in de productzoekfunctie en in search_products. Borden bewaren producten (sourceType product) zoals een zoekopdracht ze het laatst toonde, en het zoeken in alles wat is bewaard, vindt ze op hun titel en winkel.
• De MCP-server heeft 73 tools.

Ook gewijzigd op 23 oktober 2026 (productfilters):

• De productzoekfunctie accepteert meer benoemde filters: de omzetschatting van een maand of een dag (minEstMonthlySales, minEstDailySales en hun maximums; de grens van een dag is 30 dagen daarvan), verkochte stuks per maand of per dag (minUnitsSoldMonthly, minUnitsSoldDaily), sellingCountries (een product dat aan een van die landen verkoopt), shopCountries, de reviewscore (minRating, maxRating), minAdsLaunched (Meta-advertenties gelanceerd in de laatste 30 dagen), minSpendShare, minEuReach (het EU-bereik over 30 dagen), hasPartnershipAds, promoTypes (percent-off) en minShopProductsCount, elk met zijn maximum waar er een is; GET /v1/filters/products toont ook de landen van de winkels.
• sortBy accepteert estSales (de omzetschatting), adPressure (het advertentieaandeel) en bestSelling (de bestsellerrang in de winkel, rang 1 eerst), en searchType accepteert productDescription en url.
• Elk product heeft zijn nieuwste advertenties (advertising.latestAds, met de afbeeldingen in advertising.previewUrls) en zijn weken (weeks: live advertenties, advertentieaandeel, EU-uitgaven en bereik per dag), en bestSeller.rankPercent is de rang als percentage van de producten van de winkel (laag is beter).

Gewijzigd op 24 oktober 2026 (parameters, mislukte leesacties en diepe pagina's):

• Een queryparameter die een route niet leest, wordt geweigerd met 400 validation_failed, waarvan het bericht de parameter noemt en de parameters toont die de route accepteert, terwijl hij vroeger zonder melding werd genegeerd (een verkeerd gespelde naam, of een filter dat naar een route zonder filters werd gestuurd, kreeg een antwoord alsof hij nooit was verstuurd). Zoekopdrachten weigeren zoals voorheen een onbekend benoemd filter. Een gewone parameter (country, mediaType, active, type) die een filter instelt dat ook door een benoemd filter wordt ingesteld, op een andere waarde, wordt ook geweigerd.
• Merktrackers: /ads en /timeline/metadata weigeren een snapshotDate in het verleden (ze lezen de advertentiebibliotheek zoals die nu is), /partnership-ads een onbekende sortBy, /v1/workspace/scaling-ads een onbekende period, en de trackeroverzichten een hasNewAdsSince van meer dan 30 dagen terug (de tellers voor nieuwe advertenties dekken 30 dagen). /v1/workspace/hooks, /ad-copies en /landing-pages lezen de rijen van elk merk in de gevraagde sortBy en order voordat ze worden samengevoegd. De rapporten over alle merken op de website sturen euOnly alleen naar de rapporten die het lezen.
• Vergelijkbare winkels weigeren displayInTrending in filters (de lijst heeft geen vlag uit de winkelindex) en lezen de groeigrenzen als percentages, net als een winkelzoekopdracht; een offset voorbij wat één verzoek kan lezen (600 winkels verder dan die al gelezen zijn) wordt geweigerd met een 400 die zegt hoe diep het kan gaan, en een pagina waarin het lezen stopte, heeft meta.partial met een waarschuwing. De TikTok-bibliotheek van een winkel weigert profiel- en sitefilters (de eigen afbakening van de winkel neemt hun plaats in).
• Een deel van een antwoord dat de databron deze keer niet kon lezen, zet meta.partial met een waarschuwing (en het antwoord wordt niet gecachet), nooit een stil gat of een lege lijst; een antwoord van de databron dat geen JSON is, is een 503 upstream_error, en een bewaarde winkel, een nieuwe tracker of een lijst met e-mailopties waarvan het lezen mislukt, antwoordt met de fout, nooit met not_found. Een pagina dieper dan één leesactie van een lijst die rijen weglaat bereikt, heeft meta.partial en hasMore true, en de advertentieteksten, partners en creatieve tests van een merk melden met meta.partial wanneer één leesactie het merk niet dekt.
• GET /v1/google-ads/facets/networks accepteert search, limit en offset, net als de andere optielijsten. metric van /v1/shops/compare is verplicht (de referentie zei optioneel).
• MCP: een tool weigert een argument dat de gekozen soort niet leest (shop_report, lookup_filter_ids, market_overview, scan_advertiser) en argumenten die elkaar tegenspreken (trend_signal met sort_by, active_only met status, een benoemd argument met filters); creative_inspiration_pack rangschikt de advertenties van alle zoekwoorden samen.

Ook gewijzigd op 24 oktober 2026 (zoeken op afbeelding):

• Nieuw: POST /v1/products/image-search vindt de winkelproducten die op een afbeelding lijken, elk met zijn winkel, de meest gelijkende eerst. Stuur de afbeelding als multipart/form-data: een PNG-, JPG- of WEBP-bestand van maximaal 10 MB (image), of een directe afbeeldings-URL (imageUrl), die we zelf downloaden. Elke rij is een productrij zoals de productzoekfunctie die geeft, met similarity (0,7 tot 1) en matchOnly (een match waarvan de productindex geen record heeft: alleen de titel, afbeelding, prijs, lanceerdatum en winkel).
• De zoekopdracht accepteert de benoemde filters van de productzoekfunctie, sortBy (relevance, estSales, activeAds, adPressure, newest, spend, spend14d) en maxPerShop (de 1, 3, 5, 10 of 20 meest gelijkende matches per winkel), in pagina's van maximaal 32. GET /v1/products/image-search/{searchId} leest de andere pagina's, sorteringen, filters en resultaten per winkel zonder de afbeelding opnieuw te sturen, en GET /v1/products/image-search/history toont je eigen recente zoekopdrachten op afbeelding.
• De afbeelding wordt opnieuw weggeschreven voordat ze wordt doorzocht, als JPEG zonder metadata (EXIF, locatie, opmerkingen), en een afbeeldings-URL verlaat onze servers nooit. Nieuwe fouten: 400 invalid_image, 400 unsupported_url en 422 unreadable_image.
• Bij het Free-abonnement wordt zoeken op afbeelding gerangschikt op relevantie, zonder filters. De MCP-server heeft 67 tools: search_products_by_image is nieuw.

Gewijzigd op 25 oktober 2026 (credits):

• De API en de MCP-server worden gemeten in credits in plaats van verzoeken: 1 credit = 1 geretourneerd resultaat: de details van één merk, één advertentie of één rij van een lijst. Een leeg resultaat is gratis. Een aanroep kost de resultaten die hij teruggeeft, en het maandelijkse tegoed van de abonnementen is in credits.
• Gemeten antwoorden sturen X-Usage-Cost, X-Credits-Used, X-Credits-Remaining en X-Credits-Source mee; GET /v1/usage meldt de opwaardeercredits onder credits.topup.balance.
• 402 insufficient_credits komt zodra de credits van de maand en de opwaardeercredits allebei op zijn, met details.upgradeUrl en details.topUpUrl.
• De snelheidslimiet wordt gedeeld door de hele werkruimte.

Deellinks (shareUrl) openen een webpagina op https://sellwinners.com die iedereen kan bekijken. Hetzelfde record is als JSON beschikbaar via /v1/shared/ads/{token} en /v1/shared/boards/{token}. Een link waarvan de eigenaar op het Free-abonnement zit, antwoordt 403 forbidden tot de eigenaar terug is op een betaald abonnement.

De identiteitsendpoints /v1/me, /v1/usage en /v1/workspace geven hun objecten op het hoogste niveau terug, naast requestId. De systeemendpoints /v1, /v1/health en /v1/system/freshness bevatten geen requestId, en /v1 en /v1/health antwoorden met een gewoon object zonder data. De request-id wordt ook meegestuurd in de header X-Request-Id. Vermeld die als je contact opneemt met support.

Borden, favorieten en merktrackers hebben ook POST-, PATCH- en DELETE-endpoints. Ze accepteren een JSON-body, verstuurd met Content-Type: application/json.

Paginering

Lijstendpoints accepteren limit (maximaal 100 bij zoekopdrachten; facetoverzichten accepteren maximaal 500 en de /snapshots van een merk maximaal 365) en ofwel page (1, 2, 3…) ofwel offset. Als beide worden verstuurd, wordt offset gebruikt. De standaard paginagrootte staat bij elk endpoint. Overzichten van advertenties, Google-advertenties, TikTok, e-mails en media antwoorden met:

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

Overzichten van winkels, producten en adverteerders, en de advertenties van één adverteerder, antwoorden met:

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

Herhaal voor de volgende pagina hetzelfde verzoek met page plus één, of met offset plus limit. Stuur in een POST …/query-body "page" of "offset" als velden mee. hasMore is false op de laatste pagina. Als de databron een zoekopdracht na een bepaald punt niet voortzet, antwoordt de pagina die dat punt bereikt hasMore false met meta.partial true en een waarschuwing die zegt hoeveel resultaten kunnen worden gelezen. Pagineren bereikt de eerste 5.000 resultaten van een zoekopdracht (bij een adverteerderszoekopdracht de eerste 100). Beperk de zoekopdracht met filters of wijzig de sortering om andere resultaten te zien.

Overzichten van Google-advertenties geven een exacte total, behalve een lijst die de regel voor status of dagen actief beperkt (zie de zoekfunctie voor Google-advertenties). Een "totalEstimated": true markeert een total (en de bijbehorende totalPages) die een schatting is tot de lijst tot het einde is gelezen, zoals bij de vergelijkbare winkels van een winkel en een zoekopdracht naar Meta-advertenties van een winkel (websiteIds).

Borden, favorieten en rapporten van merktrackers accepteren page en limit en antwoorden met page, limit, total, totalPages en hasMore. Facetlijsten, de /products van een winkel en de /similar-winkels accepteren limit en offset en antwoorden met limit, offset, total en hasMore.

Sorteren & filters

Zoekendpoints accepteren sortBy en order (standaard desc). Als je een zoekterm meegeeft, worden de resultaten gesorteerd op relevance, tenzij je een andere sortering kiest; zonder zoekterm is de standaard newest (winkels en producten: relevance, media: reach). Zoekopdrachten naar Google- en TikTok-advertenties worden altijd op relevantie gerangschikt; daar geldt sortBy als je zonder zoekterm bladert.

Elke dataset heeft een POST …/query-endpoint dat een JSON-body accepteert met query, filters, sortBy, order, limit en page (of offset) voor geavanceerd filteren. Gebruik de facet-endpoints om de waarden en id's te zien die de filters accepteren.

Filters kunnen op naam worden verstuurd: als extra queryparameters bij een GET-zoekopdracht (?status=active&minDaysRunning=30&mainCountries=US,GB) of als velden op het hoogste niveau van een POST …/query-body ({"status": "active", "minDaysRunning": 30}). Elk endpoint hieronder toont de namen die het accepteert. Bij de zoekendpoints geeft een filternaam die het endpoint niet ondersteunt een 400 validation_failed die de ondersteunde namen toont, zodat een typefout nooit stilletjes ongefilterde resultaten oplevert; de rapporten van merktrackers negeren namen die ze niet kennen. Lijsten accepteren door komma's gescheiden waarden of een JSON-array, datums gebruiken 2026-01-31, en het ruwe object filters werkt nog steeds naast benoemde filters.

Groeifilters (trafficGrowth, adsGrowth, pageReachGrowth, adReachGrowth) accepteren regels in de vorm {"comparison": "greater" | "lower", "value": 50} of {"operator": "gte" | "lte", "value": 50}. Waarden zijn percentages over de laatste 30 dagen; andere periodes zijn niet beschikbaar. minRankDelta is het minimum aantal posities dat een advertentie heeft gewonnen over rankDeltaWindow (7d, tenzij je 14d of 30d stuurt). hideSavedAds laat de advertenties weg die je al hebt bewaard. Categorie-id's voor elk filter categoryIds komen uit /v1/facets/categories.

Snelheidslimieten & credits

1 credit = 1 geretourneerd resultaat: de details van één merk, één advertentie of één rij van een lijst. Een leeg resultaat is gratis. Elk abonnement bevat credits voor de maand, vernieuwd om 00:00 UTC op de 1e. Een aanroep kost de resultaten die hij teruggeeft, dus een kleinere limit kost minder, en een MCP-toolaanroep kost, net als bij de API, de resultaten die hij teruggeeft. Credits en de snelheidslimiet gelden per werkruimte: iedereen erin, al haar sleutels, de API en de MCP-server delen één pot credits en één snelheidslimiet. Bij een betaald abonnement kan de eigenaar van de werkruimte opwaardeercredits kopen op de factureringspagina (voor €1 krijg je 120, vanaf €10): ze worden gebruikt na de credits van de maand, schuiven door en verlopen nooit.

Elk gemeten antwoord bevat:

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

Boven de snelheidslimiet per minuut krijg je 429 rate_limited met een header Retry-After (in seconden). Als de credits van de maand en de opwaardeercredits allebei op zijn, krijg je 402 insufficient_credits, met details.upgradeUrl en details.topUpUrl, tot de maandelijkse credits worden vernieuwd. Controleer je credits op elk moment met GET /v1/account of GET /v1/usage. Deze aanroepen kosten niets, sturen nog steeds X-Usage-Cost: 0, X-Credits-Used: 0 en X-Credits-Remaining mee, en werken ook als de credits op zijn.

Deze limieten gelden voor de API en de MCP-server, bij betaalde abonnementen en bij Free. De web-app op de website wordt niet gemeten: bij betaalde abonnementen is hij onbeperkt binnen redelijk gebruik.

Het Free-abonnement

Het Free-abonnement omvat de web-app en de MCP-server (150 credits per maand), zonder de API. Een Free-account maakt in zijn dashboard een sleutel voor de MCP-server (AI-agents), binnen 150 credits per maand en 10 verzoeken per minuut; de REST API hoort bij betaalde abonnementen: met een Free-sleutel antwoordt die 403 plan_not_eligible, met details.feature, details.requiredPlan en details.upgradeUrl, op elk endpoint behalve GET /v1/account, en er wordt niets geteld. Een sleutel die op een betaald abonnement is gemaakt, wordt op Free gepauzeerd en werkt weer zodra het account terug is op een betaald abonnement. Op Free geeft een zoekopdracht de eerste resultaten, en een tool of endpoint waarvan Free de data niet omvat, antwoordt met het bericht van de betaalde abonnementen. De vergelijking van de abonnementen laat zien wat Free omvat. De demomerken zijn volledig toegankelijk op de website.

Fouten

Fouten gebruiken standaard HTTP-statuscodes en een JSON-body:

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

code is stabiel en veilig om op te vertakken, message is geschreven voor mensen, en details bevat extra data als die er is (de afgewezen velden van een 400; de maandelijkse credits, de vernieuwingsdatum, upgradeUrl en topUpUrl van een 402).

Media-URL's

Afbeeldingen en video's in antwoorden worden geleverd vanaf ons CDN op https://api.sellwinners.com/v1/media/file/…. Voor deze URL's is geen API-sleutel nodig en ze kosten geen credits, dus je kunt ze direct insluiten in <img>- en <video>-tags. Een bestand dat de databron niet meer heeft, wordt een dag lang als null verstuurd, en een ontbrekend bestand antwoordt met een lege 404 van zijn mediatype. Productafbeeldingen en app-iconen die op het CDN van Shopify staan, worden ook vanaf ons CDN geleverd. Om een afbeelding klein te tonen, voeg je ?w=96 (miniaturen) of ?w=480 (kaarten) toe: een JPEG-, PNG-, WebP- of GIF-afbeelding wordt dan als WebP verstuurd met hoogstens die breedte, nooit groter gemaakt; een animatie, een kleinere afbeelding of een video komt zoals hij is. Gebruik voor een platte, direct toonbare lijst met creatives /v1/media.

Om een afbeelding op haar eigen formaat maar lichter te tonen, voeg je ?w=full toe: een JPEG-, PNG-, WebP- of GIF-afbeelding wordt dan als WebP verstuurd op haar eigen breedte en hoogte, in een kwaliteit die er hetzelfde uitziet, als dat minstens een tiende van het bestand bespaart; anders, en voor een animatie of een video, komt het origineel zoals het is. Zonder w wordt het originele bestand verstuurd.

Ontdekken

Zet een naam, een domein of een pagina-ID om in de ID's die de andere endpoints gebruiken.

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"

Winkels

Zoek Shopify-winkels en haal hun producten, verkeer, verkopen, sociale accounts en advertenties op.

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"

Markt

De dagtotalen van de hele markt, en het Q4-seizoen ervan.

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"

Meta-advertenties

Facebook- en Instagram-advertentiecreatives met media, bereik en 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

Google-advertentiecreatives.

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

TikTok-advertenties en organische posts.

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"

Media

Creatives klaar voor weergave: URL's van afbeeldingen en video's op ons 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"

Adverteerders

Adverteerders (Facebook-pagina's) en hun activiteit.

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

Marketing- en nieuwsbriefmails van merken.

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"

Producten

Winkelproducten met hun prijs, verkopen, reviews, advertenties en EU-bereik.

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"

Facetten

De waarden en ID's die de zoekfilters gebruiken.

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"

Borden

Bewaar advertenties, winkels, producten, e-mails en adverteerders op borden, en deel ze.

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"

Favorieten

Favoriete advertenties, winkels en e-mails, in mappen.

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

Opgeslagen weergaven

De zoekopdrachten die je op de lijstpagina's van de website hebt opgeslagen, per pagina.

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"

Merktrackers

Volg merken en lees rapporten over hun advertenties, creatives en landingspagina's.

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