API-Dokumentation für E-Commerce-Daten

Die API von SellWinners liefert Ihnen Daten zu E-Commerce und Werbung über HTTPS mit JSON-Antworten: Shopify-Shops mit ihren Produkten und ihrem Traffic; Shop-Produkte mit Preis, Umsatzschätzungen, Bewertungen und Anzeigen; Meta-, Google- und TikTok-Anzeigen; Werbetreibende; und die E-Mails, die Marken versenden. Jeder Endpunkt steht KI-Agenten auch über unseren gehosteten MCP-Server zur Verfügung. Diese Seite behandelt die Authentifizierung, das Antwortformat, Paginierung, Sortierung und Filter, Ratenlimits und Credits, Fehler und Medien-URLs, dann jeden Endpunkt mit seinen Parametern und einer Beispielanfrage sowie die Tools des MCP-Servers.

Schnellstart

1. Erstellen Sie ein Konto, bestätigen Sie Ihre E-Mail-Adresse und wählen Sie einen kostenpflichtigen Tarif: Damit stehen Ihnen die API und der MCP-Server offen.
2. Öffnen Sie API-Schlüssel und erstellen Sie einen Schlüssel. Kopieren Sie ihn sofort: Er wird nur einmal angezeigt.
3. Senden Sie Ihre erste Anfrage:

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

Authentifizierung

Senden Sie Ihren API-Schlüssel bei jeder Anfrage im Header X-API-Key oder als Bearer-Token:

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

Schlüssel beginnen mit ak_live_. Halten Sie sie geheim: Verwenden Sie sie nicht in Frontend-Code oder öffentlichen Repositorys. Sie können mehrere Schlüssel erstellen (einen pro App oder Umgebung) und jeden Schlüssel in Ihrem Dashboard widerrufen; ein widerrufener Schlüssel funktioniert sofort nicht mehr.

Antworten

Jede Antwort ist JSON. Sie enthält eine requestId und das Ergebnis unter data: eine Liste bei Suchen und Auflistungen, ein Objekt bei einem einzelnen Datensatz. Listen enthalten zusätzlich ein Objekt pagination, und manche Antworten enthalten zusätzlich meta.

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

Datensätze sind verschachtelte Objekte: Eine Anzeige hat media, advertiser, content, metrics, audience, rank und flags, und Shops, Werbetreibende, Google-Anzeigen, TikTok-Elemente und E-Mails sind genauso gruppiert. Ein unbekannter Wert ist null. Weitere Felder ohne festen Platz stehen unter extra. Das Beispiel oben ist gekürzt.

In einer Anzeige ist content.title die Überschrift und content.callToAction ein lesbarer Text wie »Shop now«. metrics.estimatedSpend ist die Ausgabenschätzung der Quelle, wenn es eine gibt (eine einzelne Anzeige von /v1/ads/{adId} liest sie), andernfalls Reichweite x 9 / 1000 (9 USD pro 1.000 erreichte Personen); eine Ausgabenschätzung hat unter 10 USD zwei Dezimalstellen und ist ab 10 USD in ganzen Dollar angegeben. rank.rankDelta ist der aktuelle Rang minus der vorherige, ein negativer Wert bedeutet also, dass die Anzeige aufgestiegen ist, und rank.improvementPct ist ein Bruchteil (0,25 ist ein Viertel).

Die Rangberichte des Marken-Trackers (/ad-rank, /scaling-ads, /v1/workspace/scaling-ads und das MCP-Tool get_brandtracker_scaling_ads) fügen eigene metrics hinzu: Dort ist metrics.rankDelta der vorherige Rang minus der aktuelle (positiv: gewonnene Plätze) und metrics.improvementPct der Anteil des vorherigen Rangs, der gewonnen wurde, wie bei einer Anzeige (0,875 entspricht 87,5 %). Bei einer einzelnen Anzeige werden metrics.reachDelta1d, reachDelta7d und reachDelta30d aus ihrem Reichweitenverlauf befüllt. Shops nennen ihre Kategorien: catalog.mainCategory in Auflistungen, dazu catalog.categories bei einem einzelnen Shop.

In einer Google-Anzeige sind media.type und media.format jeweils text, image oder video, und media.url ist das Bild der Anzeige: bei einer Videoanzeige ihr Vorschaubild (es gibt keine Videodatei). transparencyUrl ist die Anzeige im Ads Transparency Center von Google, wo eine Videoanzeige abgespielt wird; der Wert ist null, wenn die Anzeige keine Google-IDs hat. network ist search, youtube, shopping, maps oder other, und dasselbe gilt für die Werte von extra.networks.

Geändert am 19. Oktober 2026:

• Das media.format einer Google-Anzeige war ein Formatcode und ist jetzt text, image oder video, ihr media.type kann text oder video sein, und extra.networks verwendet die kleingeschriebenen Namen von network.
• Bei Google ist media.url nie eine Videodatei, auch wenn media.type den Wert video hat.
• Im Google-Filter formats bedeutet image jetzt Bildanzeigen (früher bedeutete es Textanzeigen), verwenden Sie also text für Textanzeigen. Die früheren Codes static_image, html5_iframe und responsive_display sowie ihre Kurznamen werden weiterhin akzeptiert.

Der status einer Google-Anzeige ist nur active, solange Google die Anzeige zeigt: Eine Anzeige, die Google seit mehr als 7 Tagen nicht gezeigt hat, ist unknown. daysRunning zählt die Tage von firstSeenAt bis lastSeenAt, beide eingeschlossen; extra.servedDays ist die eigene Zählung der Datenquelle, die weiterläuft, nachdem eine Anzeige gestoppt wurde. Die Filter stimmen mit dem überein, was jede Anzeige zeigt: status=active behält die Anzeigen, die Google in den letzten 7 Tagen gezeigt hat, und status=inactive die Anzeigen, die die Datenquelle als gestoppt markiert, sodass eine Anzeige mit unknown unter keinen der beiden fällt; minDaysRunning und maxDaysRunning behalten die Anzeigen, deren daysRunning im Bereich liegt. Eine solche Liste hat pagination.total null, und wenn nur wenige der gelesenen Anzeigen passen, endet sie früh, mit meta.partial und einer Warnung.

Ohne Suchtext listet sortBy=relevance die neuesten auf; sortBy=reach nimmt nur order=desc an. Mit status=active listet sortBy=reach wenige Anzeigen auf: In der Reihenfolge nach Reichweite sind die ersten Anzeigen meist solche, die Google nicht mehr zeigt, sortieren Sie also nach den neuesten, um die Anzeigen zu erhalten, die Google jetzt zeigt (die Warnung sagt das auch). Google-Anzeigen nehmen kein sortBy=longestRunning an: Die Datenquelle ordnet es nach Tagen, die weiterlaufen, nachdem eine Anzeige gestoppt wurde, daher listete es Anzeigen auf, die Google nicht mehr zeigt, und es antwortet mit 400 und diesem Grund.

extra.startIsFloor markiert eine Anzeige, die zuerst am 31. Mai 2018 gesehen wurde, dem ersten Tag der Google-Anzeigendaten, sie kann also älter sein. audience.countries listet jedes Zielgruppenland auf, mit einem percentage nur bei einer Anzeige, die in einem einzigen Land gezeigt wurde; remarketing und interest sind null, wenn sie unbekannt sind.

Google meldet eine Reichweite nur für einige der in der EU gezeigten Anzeigen, oft nur als 10.000.000, das obere Ende seiner Skala (10 Millionen oder mehr): Die meisten Anzeigen haben keine, und nullReasons sagt, warum reach.value den Wert null hat (not_reported: eine in der EU gezeigte Anzeige, für die Google keine meldet; eu_only: eine anderswo gezeigte Anzeige), außer bei einer Reichweite, die der Tarif nicht enthält. extra.networks ist die Liste der Plattformen der Anzeige laut Datenquelle, die network nicht unbedingt nennt. extra.shop.google enthält die Google-Summen der Website des Werbetreibenden; bei einer Website, die kein Shop ist (ein App-Store, ein soziales Netzwerk, ein Linkverkürzer), sind advertiser.domain und websiteId null.

Geändert am 20. Oktober 2026:

• Eine Domain (GET /v1/shops/{domain}, der Lookup, eine TikTok-domain, das Wettbewerber-Briefing) ist die Website mit genau dieser Domain, auch außerhalb des Shop-Index; eine Domain, die die Datenquelle nicht erreicht, liefert 404.
• GET /v1/lookup ordnet die Ergebnisse vom besten an: die eigene Website einer Domain, ihre eigenen Facebook-Seiten (Hauptseite zuerst), dann die Seiten mit ähnlichem Namen; bei einem Namen die eigene Website der Marke und ihre eigenen Seiten (Hauptseite zuerst), dann die Shops und Seiten, die über den Namen gefunden wurden.
• Wenn die Website der Marke gefunden ist, wird ein Shop oder eine Seite, die den Namen nur innerhalb eines Wortes enthält, ausgelassen, und eine Website dieses Namens ist nur dann ein exakter Treffer, wenn sie Anzeigen schaltet; andernfalls ist ein Namenstreffer nur mit Traffic oder Anzeigen exakt. Offizielle Seiten mit einem anderen Namen ohne laufende Anzeige kommen nach den über den Namen gefundenen Seiten.
• signals.activeAdsSource einer Shop-Zeile sagt, woher ihre activeAds stammen: page (die laufenden Anzeigen ihrer Hauptseite, jetzt gelesen, in der eigenen Zeile des Shops) oder index (die Zählung des Shop-Index, die älter sein kann).
• Eine Shop-Suche nach Domain (searchType=domain) listet die exakte Website zuerst auf, mit extra.exactDomainMatch (und extra.inShopIndex false, wenn der Shop-Index sie nicht enthält).
• Bei einer Website, die kein Shop ist (ein App-Store, ein soziales Netzwerk oder Messaging-Dienst, ein Linkverkürzer oder eine Tracking-Weiterleitung), ist extra.domain einer Werbetreibenden-Zeile null, ein Werbetreibenden-Datensatz nennt sie in extra.nonShopSite, lässt extra.platforms weg und bezieht linkedShops aus seinen Landingpages (fromLandingPages), und eine Anzeige hat keine shops.
• Datums- und Zeitangaben, die die Datenquelle ohne Zeitzone sendet, sind UTC und werden jetzt mit +00:00 gesendet.
• In den E-Mail-Statistiken ist emailsByDayOfWeek nach der Nummer des Tages geschlüsselt: 0 ist Sonntag, 6 Samstag.
• Lookup-Zeilen können nullReasons enthalten, und ein Shop-Datensatz meta.partial, wenn seine Werte aus der Auflistung nicht gelesen werden konnten.

Ebenfalls geändert am 20. Oktober 2026 (TikTok):

• Das publishedAt eines TikTok-Elements ist UTC. Es lag 1 oder 2 Stunden zu spät, sodass ein Post aus den letzten Stunden eines UTC-Tages beim nächsten Tag erschien und ein daysRunning einen Tag zu kurz war.
• Die Filter stimmen damit überein: publishedAfter und publishedBefore sind UTC (ein Datum allein ist der Beginn seines Tages, und publishedBefore listet die Posts davor auf), minDaysRunning und maxDaysRunning zählen ab dem UTC-Tag, wie daysRunning, und sortBy=longestRunning beginnt am 31. August 2016, 22:00 UTC.

Ebenfalls geändert am 20. Oktober 2026 (Google-Anzeigen):

• GET /v1/google-ads, POST /v1/google-ads/query und das MCP-Tool nehmen kein sortBy=longestRunning (und kein daysRunning) an und antworten mit 400 und dem Grund: Die Datenquelle ordnet es nach Tagen, die weiterlaufen, nachdem eine Anzeige gestoppt wurde, daher listete es Anzeigen auf, die Google nicht mehr zeigt.
• Eine Free-Suche, deren erste Ergebnisse durch status=active knapp ausfallen, antwortet mit meta.partial und einer Warnung, die sagt, wie viele der gelesenen Anzeigen sie auflistet.
• In extra.shop hat eine Website ohne Traffic-Daten kein monthlyVisits (es war 0), ein trafficGrowth30d kommt nur neben Besuchen über 0, und extra.shop.google lässt ein totalReach oder weeklyReach von 0 weg (nie gemeldet) und, wenn es keine Anzeige zählt, die Zählungen von 0.
• Eine in einem Board gespeicherte Google-Anzeige liest sich genauso.

Ebenfalls geändert am 20. Oktober 2026 (Shops):

• In GET /v1/shops/{shopId} ist advertising.summary.reach30d die EU-Reichweite der letzten 30 Tage, nach Datum summiert (es war die Summe seit Beginn der Erfassung, jetzt totalReach), spend30d ist diese Reichweite x 9 / 1000, extra.estimatedSpendUsd sind die Ausgaben seit Beginn der Erfassung, und extra.adsLaunched30d summiert die in den letzten 30 Tagen gestarteten Anzeigen; alle sind null bei einem Shop ohne Reichweite in der EU oder im Vereinigten Königreich.
• Shop-Datensätze, aufgelistete Shops und E-Mail-Statistiken enthalten nullReasons, eine Zuordnung jedes Feldpfads zu dem Grund, warum er null ist: not_shopify (Umsatz und Produkte werden nur für Shopify-Shops geschätzt), no_estimate, not_measured, eu_uk_only, not_linked (kein TikTok-Profil), not_on_tp, no_reviews, none_found.
• Eine Umsatzschätzung von 0 neben verkauften Einheiten ist null, in Datensätzen, Auflistungen und im Umsatzverlauf, dessen period=week einen Punkt pro Woche hat.
• traffic.growth30d ist ein Bruchteil (-0,1543 entspricht -15,4 %), und traffic.history beginnt beim ersten Monat mit Besuchen.
• catalog.mainCategory stammt aus den Kategorie-IDs (die spezifischste des Hauptzweigs), mit catalog.categoryLeaves und productsCountCapped (25.001 ist die Obergrenze der Datenquelle: 25.000 oder mehr).
• Bei einer Trustpilot-Seite ohne Bewertung ist die Bewertungsnote null.
• tiktok.matchedBy ist socials oder handle, wenn die TikTok-Zahlen aus den Social-Media-Profilen des Shops stammen oder aus einem Profil, das über seinen Handle gefunden wurde (ein Treffer, keine Verknüpfung der Datenquelle).
• advertising.mainPageActiveAds sind die laufenden Anzeigen der Hauptseite (der Wert aus ihrer Anzeigenübersicht, wie ihn ihre Hauptseite in linkedAdvertisers zeigt; die Zählung der Shop-Listen nur, wenn es keinen gibt) und linkedAdvertisers[].rank der Rang der Seite.
• Ähnliche Shops lassen den Shop selbst und seine eigenen Websites weg, und jede Seite wird von weiter unten in der Liste aufgefüllt (offset und limit zählen die Liste ohne sie).
• Nach Beliebtheit sortierte Produkte stellen die Bestseller des Shops an den Anfang (meta.order).
• Die E-Mails und E-Mail-Statistiken eines Shops zählen jeden Kampagnentyp, und ihre 90-Tage-Werte sind null, wenn sie unbekannt sind.
• Eine Sortierung nach Umsatz listet eine Zeile pro Shopify-Shop auf (extra.sharedSalesWith), und sortBy=estMonthlySales&order=asc lässt die Shops ohne Schätzung weg.

Ebenfalls geändert am 20. Oktober 2026 (Shop-Zahlen):

• Eine Sortierung nach Umsatz in GET /v1/shops liest über die Domains hinaus weiter, die sie zu einer Zeile pro Shopify-Shop zusammenführt (sie hörte nach den ersten Zeilen auf), führt die Domains eines Shops auch weiter unten in der Liste zusammen, und ihr pagination.total ist null, bis die Liste bis zum Ende gelesen ist; sortBy=estMonthlySales&order=asc beginnt bei einer Schätzung von 100 USD (minMonthlySales 100).
• Eine Umsatzschätzung unter 0,50 USD pro verkaufter Einheit ist null (no_estimate), in Datensätzen, Auflistungen und im Umsatzverlauf.
• traffic.monthlyVisits ist null bei einer noch nicht gemessenen Website und traffic.growth30d, wenn der Vormonat keine Besuche hatte (not_measured); das growth30d eines sozialen Netzwerks stammt aus seinem Follower-Verlauf, wenn die Datenquelle 0 oder nichts liefert, und 0 Follower sind null (not_measured).
• Aufgelistete Shops sagen, warum catalog.productsCount und sales.unitsSold null sind.
• extra.storeWide markiert eine Domain mit 0 Besuchen, die den Umsatz ihres Shops trägt (eine gemessene 0, oder eine andere Domain des Shops, genannt in extra.sharedSalesWith, hat die Besuche; Free lässt den Namen in einem Shop-Datensatz weg).
• advertising.mainPageActiveAds sind die laufenden Anzeigen der Hauptseite, wie ihre Anzeigenübersicht sie liest (die Zählung der Shop-Listen nur, wenn es keine gibt).
• Ähnliche Shops lassen auch die Marken-Shops des Shops weg, und extra.similarIndexed ist false bei einem Shop, den der Ähnlichkeitsindex nicht enthält.
• catalog.mainCategory behält die eigene Bezeichnung der Datenquelle nur, wenn sie der Name einer Kategorie ist.
• Eine Mediendatei, die eine Antwort verlinkt hat und die die Datenquelle nicht mehr hat, antwortet mit 200, einem leeren Body und X-Media-Missing: true.

Ebenfalls geändert am 20. Oktober 2026 (Werbetreibende und Meta-Anzeigen):

• Die Reichweite eines Werbetreibenden ist die Reichweite in der EU und im Vereinigten Königreich, in den eigenen Zeitfenstern der Werbetreibenden-Suche: advertising.reach30d, extra.reach14d, reach90d und totalReach sind null bei einer Seite ohne Anzeigen in der EU oder im Vereinigten Königreich und ohne Reichweite oder bei einem Zeitfenster, das die Datenquelle nicht gezählt hat, und nullReasons sagt, warum (eu_uk_only, not_measured); eine innerhalb eines Zeitfensters erstellte Seite hat ihre gesamte Reichweite darin (sie waren 0).
• In GET /v1/advertisers/{advertiserId} ist die Reichweite diejenige, die Werbetreibenden-Listen zeigen (sie wurde 30 Messungen zurück gelesen, und Messungen überspringen Tage), die Ausgabenschätzungen sind null, wenn sie es ist, extra.avgSpendUsd14d sind die durchschnittlichen täglichen Ausgaben über 14 Tage, extra.avgActiveAds14d ist der 14-Tage-Durchschnitt ihrer laufenden Anzeigen (es waren ihre neuen Anzeigen über 14 Tage), wo die Datenquelle ihn nicht berechnet hat, bei einer innerhalb der 14 Tage erstellten Seite aus ihren seit ihrem ersten Tag gelesenen laufenden Anzeigen (extra.averagedFrom), sonst null, und die Zählungen neuer Anzeigen einer innerhalb des Zeitfensters erstellten Seite zählen jede ihrer Anzeigen.
• advertising.countryDistribution ist der Anteil ihrer laufenden Anzeigen, die auf jedes Land zielen (eine Anzeige zielt auf mehrere), extra.reachCountries enthält den Anteil jedes Landes an der EU-Reichweite, extra.platforms.meta enthält die eigenen Anzeigen der Seite (es enthielt die der Hauptseite des Shops), eine TikTok- oder Google-Zählung ohne Wert wird weggelassen, extra.mainLandingPages greift auf die Vorschau der Landingpages einer neuen Seite zurück, und die lastAds einer Seite, deren Anzeigen die Anzeigensuche noch nicht aufgenommen hat, sind die neuesten, die ihre Werbetreibenden-Zeile auflistet, mit meta.indexing, wie bei GET /v1/advertisers/{advertiser_id}/ads (mit meta.liveAds).
• Neu: GET /v1/advertisers/{advertiserId}/history, die laufenden Anzeigen der Seite und die gewonnene EU-Reichweite, Tag für Tag.
• Eine Instagram-Follower-Zahl von 0 ist null (die Datenquelle schreibt 0 für eine Seite ohne ein ihr bekanntes Konto).
• metrics.reach und die Ausgaben einer Meta-Anzeige sind null bei einer Anzeige, die nicht in der EU oder im Vereinigten Königreich gezeigt wurde (eu_uk_only; sie waren 0 oder null), und bei einer EU-Anzeige, deren Reichweite noch nicht gezählt ist (not_measured; sie war 0), wobei Medienzeilen den Grund in nullReasons.reach nennen, media.type ist carousel bei einer Anzeige mit mehr als einem Bild oder Video, und extra.startIsFloor markiert eine Anzeige, die am 1. Januar 2018 gestartet ist, dem ersten Tag der Meta-Anzeigendaten der Datenquelle.
• sortBy=adRank listet den besten Rang (1) zuerst auf, unabhängig von der Reihenfolge.
• Eine einzelne Anzeige (GET /v1/ads/{adId}) übernimmt die neueste von der Datenquelle gemeldete Reichweite und die Ausgaben dazu, zählt ihre Reichweitendeltas nach Datum, solange ihr Reichweitenverlauf aktuell ist (sonst sind sie null), listet ihre Bilder und Videos wie ihre Suchzeile auf, befüllt advertiser.reach30d und pageAnalytics.instagramFollowersHistory, fügt pageAnalytics.reachHistory hinzu (dieselbe Reihe wie impressionsHistory) und benennt einen Shop, den der Datensatz nur über seine ID angibt (sein traffic ist null mit nullReasons shops.traffic, wenn die Website nicht gemessen wird); ihre audience.gender, ageMin, ageMax und metrics.aggregatedReach sind immer null, da die Datenquelle sie für eine einzelne Anzeige nicht meldet.
• In einer Werbetreibenden-Suche ordnet sortBy=reach nach der Gesamtreichweite seit Beginn der Erfassung und newAds nach den neuen Anzeigen über 14 Tage.
• Das Targeting einer Meta-Anzeige sagt, warum ihre Reichweite null ist: eu_uk_only nur bei einer Anzeige, die auf kein Land der EU und nicht auf das Vereinigte Königreich zielt; eine, die auf eines davon zielt oder deren Targeting noch nicht bekannt ist, ist in ihren ersten 7 Tagen not_measured und danach not_reported (sie waren eu_uk_only), in Anzeigenlisten, Medienzeilen und bei einer einzelnen Anzeige.
• Eine einzelne Anzeige liest ihre Reichweiten- und Ausgabenverläufe als eine Reihe, eine Messung pro Tag (ihre Deltas ebenso), und übernimmt die letzte Messung dieser Reihe und deren Ausgaben, wenn die Reichweite des Datensatzes mehr als doppelt so hoch ist und die Reihe bis zum letzten Tag der Anzeige reicht; ihr media greift auf ihre erste aufgeführte Datei zurück und advertiser.totalReach auf die EU-Reichweite aus den Seitendetails.
• Ein Werbetreibenden-Datensatz, dessen Zeile keine Reichweite liest, während die Seitendetails eine lesen, erhält deren Reichweite (extra.totalReach, die Ausgaben dazu, darauf gezählt advertising.reach30d), seine Anteile in extra.reachCountries werden nie auf 0 gerundet, extra.averagedFrom liegt nie vor dem Tag, an dem die Seite erstellt wurde, und sein Tagesverlauf (extra.history, GET /v1/advertisers/{advertiserId}/history) lässt die Messungen weg, die die Datenquelle verpasst hat (eine Folge von Nullen über 14 Tage oder weniger zwischen Messungen über 0).
• Eine einzelne Anzeige, die die Messung ihrer Reihe übernimmt, behält die Reichweite des Datensatzes in extra.recordReach (den Wert, den Anzeigenlisten zeigen); in einer Werbetreibenden-Suche erhält eine Zeile, die keine EU-Reichweite liest, während die Seitendetails eine lesen, deren Reichweite, wie ihr Datensatz; und GET /v1/advertisers/{advertiserId}/history behält die Messungen von 0 einer Seite, die jetzt keine EU-Anzeige hat und vor den abgefragten Tagen Reichweite gewonnen hat (sie hat keine gewonnen; sie wurden als not_measured weggelassen).
• In Free nennt eine Anzeige mit unbekannter Reichweite den Grund wie in kostenpflichtigen Tarifen; nur eine Reichweite, die der Tarif nicht enthält, hat keinen Grund.

Ebenfalls geändert am 20. Oktober 2026 (Ausgabenschätzungen):

• Geschätzte Ausgaben unter 10 USD behalten zwei Dezimalstellen: Eine Reichweite von 140 bei 9 USD pro 1.000 erreichte Personen ergibt 1,26 (es war 1), und ein Tagesdurchschnitt behält seine eigenen Cent; ab 10 USD ist eine Ausgabenschätzung in ganzen Dollar angegeben (eine Reichweite von 2.000 ergibt 18).
• Das gilt für extra.estimatedSpendUsd und extra.avgSpendUsd14d des Werbetreibenden-Datensatzes, advertising.summary.spend30d und extra.estimatedSpendUsd eines Shops, metrics.estimatedSpend einer Meta-Anzeige sowie statistics.euData.estimatedSpend30d eines Marken-Trackers und das estimatedSpend jedes Punkts von /time-series (beide hatten bei jedem Betrag zwei Dezimalstellen), in der API wie in den MCP-Tools. Wo der eigene Wert der Datenquelle diese Schätzung in ganzen Dollar ist, behält er seine Cent auf dieselbe Weise.

Ebenfalls geändert am 20. Oktober 2026 (Reichweite von Werbetreibenden und Tagesverlauf):

• GET /v1/advertisers/{advertiserId} ergänzt extra.reachScope: outside_eu_uk bei einer Seite, deren Reichweite nach Land größtenteils außerhalb der EU und des Vereinigten Königreichs gesehen wurde (die Datenquelle meldet auch die Reichweite einiger anderswo gezeigter Anzeigen; ihre Reichweite und die daraus abgeleiteten Schätzungen sind dann diese Reichweite, keine EU-Reichweite), sonst eu_uk. Ihr extra.avgSpendUsd14d ist bei einer innerhalb der 14 Tage erstellten Seite ihre Ausgabe über die vollen Tage seit ihrer Erstellung (mindestens einer; es war ihre 14-Tage-Reichweite über 14 Tage, wo die Werbetreibenden-Zeile eine hatte).
• extra.history des Werbetreibenden-Datensatzes und GET /v1/advertisers/{advertiserId}/history beginnen an dem Tag, an dem die Seite erstellt wurde; extra.history.newAds lässt seine 0 an den Tagen weg, die die Datenquelle verpasst hat, extra.followersHistory und die Likes und Follower in pageAnalytics einer Anzeige lassen eine 0 zwischen zwei Messungen über 0 oder an einem solchen Tag weg, und die täglichen Ausgabenschätzungen behalten unter 10 USD zwei Dezimalstellen.
• Eine Seite, deren laufende Anzeigen noch keine Liste enthält, hat meta.indexing in ihrem Datensatz und eine leere erste Seite von GET /v1/advertisers/{advertiser_id}/ads mit meta.indexing und meta.liveAds.
• Eine einzelne Anzeige (GET /v1/ads/{adId}): extra.spendHistory beginnt an dem Tag, an dem die Anzeige gestartet ist, jedes spendUsd mit zwei Dezimalstellen unter 10 USD; advertiser.totalReach liegt nie unter der letzten Messung von pageAnalytics.reachHistory (extra.pageRecordReach enthält dann die Summe des Datensatzes, die Werbetreibenden-Listen zeigen); extra.recordSpend sind die Ausgaben zu extra.recordReach; extra.reachScope und extra.pageReachScope sagen, wo der Großteil der Reichweite der Anzeige und ihrer Seite gesehen wurde.

Ebenfalls geändert am 20. Oktober 2026 (Marken-Tracker):

• In GET /v1/brandtrackers und GET /v1/brandtrackers/{id} wird eine 0 bei advertising.newAdsLastDay neben Starts in den letzten 7 Tagen mit den Starts des Shops von gestern abgeglichen: deren Anzahl, oder null (not_measured) ohne Messung dieses Tages; eine Auflistung prüft höchstens 20 Marken pro Aufruf, die der abgefragten Seite.
• In /top-ads und /v1/workspace/top-ads ist metrics.totalReach die EU-Reichweite der Anzeige: null bei einer außerhalb der EU und des Vereinigten Königreichs gezeigten Anzeige (eu_uk_only) oder einer noch nicht gezählten EU-Anzeige (not_measured), mit nullReasons, und zuletzt in einer Sortierung nach Reichweite (es war 0).
• /testing zählt seine Reichweitenstatistiken über die Anzeigen, deren Reichweite bekannt ist, mit nullReasons stats.reach bei einem Batch ohne solche Anzeigen.
• In /hooks, /transcripts, /landing-pages und den Hooks und Landingpages des Arbeitsbereichs ist ein totalImpressions von 0 null, mit dem neuen Grund no_eu_reach (keine EU- oder UK-Reichweite für seine Anzeigen gezählt; not_measured mit euOnly), zuletzt in seiner Sortierung.
• In /ad-rank, /scaling-ads und /v1/workspace/scaling-ads zählen metrics.previousRank und rankDelta, wenn der Rangverlauf einer Anzeige innerhalb eines Zeitfensters von 14 oder 30 Tagen beginnt, ab ihrer ältesten Messung dort: metrics.since ist dieser Tag, und meta.windowNote sagt es, und ein Wert, der nicht angegeben werden kann, ist null mit nullReasons.
• In /partners ist isOwnPage true für die Hauptseite des Shops, seine offiziellen Seiten mit dem Namen der Marke und eine Seite, die wie die Marke heißt (auch Creator können als offiziell eingestuft werden), und eine Reichweite oder Ausgabe mit dem Wert null hat nullReasons.
• Die erste Seite von /ads mit adCopyHashes hat meta.latestAdDate und dataFreshnessLagDays, und mit status=active auch meta.stoppedCount.
• /demography ist die Zielgruppe in der EU und im Vereinigten Königreich, und ein Land unter einem Zehntausendstel des stärksten wandert von countryDistribution zu otherCountries.
• /ad-copy-evolution und /headline-evolution haben einen Punkt für jeden erfassten Tag (0, wenn der Text nicht verwendet wurde, null an einem Tag, der bei den behaltenen Texten abgeschnitten ist), ordnen Texte nach dem neuesten Tag und lassen die Tage weg, die die Datenquelle falsch gelesen hat (laufende Anzeigen unter einem Zehntel der umliegenden Tage, ein Tag oder 2 oder 3 in Folge, oder weit weniger Texte als die Tage auf beiden Seiten), wie meta.periodNote sagt; meta.recordedDays zählt die Tage. Wöchentliche und monatliche laufende Anzeigen in /time-series lassen ebenfalls 2 oder 3 solcher Messungen in Folge weg.

Ebenfalls geändert am 20. Oktober 2026 (Berichte des Marken-Trackers, Lookup und Google-Reichweite):

• In /ad-rank, /scaling-ads und /v1/workspace/scaling-ads stammt jeder Rang einer Zeile aus dem Rangverlauf der Anzeige: metrics.currentRank ist ihre Messung von dem Tag, an dem der Rang der Anzeigenbibliothek gelesen wurde (der Rang, den /top-ads zeigt; die Bibliothek kann einen Tag hinter dem Verlauf liegen), sonst ihre neueste Messung, die trajectory endet an diesem Tag, und ohne Messung an dem Tag, an dem das Zeitfenster beginnt, zählt die älteste Messung darin (die eigene Veränderung der Datenquelle über das Zeitfenster wird nicht mehr verwendet).
• Die ersten 50 Anzeigen der Anzeigenbibliothek (10 pro Marke über Marken hinweg) werden nach diesen Werten neu eingestuft: Eine Anzeige, die danach weniger als minRankDelta gewonnen hat oder unterhalb von maxCurrentRank liegt, wird weggelassen (eine Anzeige, deren Rangverlauf keinen Gewinn ergibt, nach der eigenen Zählung der Anzeigenbibliothek), pagination umfasst die behaltenen Anzeigen, und meta.rankNote sagt, was gelesen und weggelassen wurde, auch über Marken hinweg.
• Eine tägliche /time-series (und der graph der Übersicht) ist null an einem Tag, dessen laufende Anzeigen die Datenquelle falsch gelesen hat (unter einem Zehntel der Tage auf beiden Seiten; der neueste Tag bleibt wie gelesen, auch in den Textverläufen), seine Starts ebenso, und das gilt auch für die Starts des Folgetags, wenn sie fast alle seine laufenden Anzeigen sind; Wochen und Monate lassen diese Starts weg, und leftOut listet die Tage auf. /landing-page-evolution lässt diese Tage bei jeder Seite weg, ebenso die eigene Messung einer Seite unter einem Zehntel der Messungen auf beiden Seiten, wie ihr meta.periodNote sagt, mit dem Tag, den der Verlauf erreicht, wenn er im Rückstand ist.
• Ein /testing-Batch ohne gezählte Reichweite hat nullReasons stats.reach no_eu_reach, außer eine seiner Anzeigen ist noch nicht gezählt (not_measured) oder alle wurden außerhalb der EU und des Vereinigten Königreichs gezeigt (eu_uk_only); fehlende Reichweite und Ausgaben einer /partners-Zeile sind nur in den 7 Tagen nach ihrem launchDate not_measured, danach no_eu_reach.
• /creatives bezeichnet eine Anzeige mit mehreren Bildern oder Videos als carousel (es war unknown).
• In GET /v1/lookup ist signals.monthlyVisits eines Shops null bei einer noch nicht gemessenen Website (nullReasons not_measured; es war 0), die laufenden Anzeigen der exakten Shop-Zeile (mit jedem type, auch shop) sind die ihrer Hauptseite, wie ihre Anzeigenübersicht sie liest, ihr mainPageActiveAds, und die Zeilen der eigenen Seiten des Shops lesen ihre auf dieselbe Weise, das signals.monthlyVisits einer verfolgten Marke (und ihr totalTraffic in GET /v1/brandtrackers) ist null bei einer noch nicht gemessenen Website und sagt, warum es fehlt (not_measured, oder no_shop bei einer Seite ohne Shop), und in Free behält die Reichweite einer Seite, die kein Tarif hat, ihren Grund (eu_uk_only, not_measured), auch in Werbetreibenden-Listen.
• Ist reach.value einer Google-Anzeige null, gibt es nullReasons (not_reported, eu_only), außer bei einer Reichweite, die der Tarif nicht enthält.
• In GET /v1/shops/{shopId} sind advertising.mainPageActiveAds die laufenden Anzeigen der Hauptseite, wie ihre Anzeigenübersicht sie liest, die Zählung, die ihre Hauptseite in linkedAdvertisers zeigt (es war die Zählung des Shop-Index, die einen Tag älter sein kann).

Ebenfalls geändert am 20. Oktober 2026 (TikTok und E-Mails):

• Das metrics.engagementRate einer TikTok-Zeile ist (Likes + Kommentare + Shares + Speicherungen) / Aufrufe als Bruchteil (0,0513 entspricht 5,13 %; Suchen lieferten einen Prozentwert und GET /v1/tiktok/library/{itemId} eine andere Kennzahl), und daysRunning sind die Tage seit der Veröffentlichung des Posts, in beiden.
• metrics.rank ist der Rang des Posts unter den Posts seines Creators (1 ist der beste).
• profile.followers ist null, wenn die Datenquelle sie nicht gezählt hat (sie lieferte 0), content.category ist null bei ihrer Sammelkategorie All, und content.hashtags sind die Tags des Posts, jeder nur einmal, geschrieben wie in seiner Beschreibung und ohne die Satzzeichen dahinter (die eines Datensatzes sind die Liste der Datenquelle, die einer Suchzeile die aus der Beschreibung).
• Ein TikTok-Datensatz ergänzt profile.adsCount, organicCount und avgPostsPerWeek90d, befüllt profile.pageCreation und hat links null bei einer Zeile der Datenquelle, hinter der kein TikTok steht (eine ID mit weniger als 15 Ziffern oder veröffentlicht vor dem 31. August 2016, 22:00 UTC).
• sortBy=longestRunning beginnt bei den ersten TikToks (31. August 2016, 22:00 UTC).
• Ein E-Mail-Datensatz nennt seinen Aktionstyp, seine Kategorie und sein Ereignis, und die monatlichen Besuche, laufenden Anzeigen, Produkte und 90-Tage-Werte seines Shops sind die, die die E-Mail-Listen zeigen, ebenso die last90Days-Werte der E-Mail-Statistiken.
• Eine E-Mail-Zeile lässt extra.shopActiveAds bei einer 0 ohne Anzeigensumme weg (ihre nullReasons sagen not_measured), und das shop.marketing.activeAds eines E-Mail-Datensatzes ist dann null; wenn die Werte des Shops nicht gelesen werden konnten, hat der Datensatz meta.partial, eine Warnung und nullReasons failed für sie.
• Im MCP-Tool analyze_shop_emails ordnet dominant Kampagnentypen, Kategorien, Aktionstypen und Ereignisse jeweils für sich und lässt No Promotion und No Event weg.

Geändert am 21. Oktober 2026:

• metrics.views eines TikTok-Elements sowie seine likes und saves, die daneben 0 lauten, sind null mit nullReasons not_measured (ebenso engagementRate), wenn die Datenquelle 0 Aufrufe neben Likes, Kommentaren, Shares oder Speicherungen über 0 geliefert hat, in Suchen und in GET /v1/tiktok/library/{itemId}; sortBy=views oder likes mit order=asc listet die Posts mit gezählten Aufrufen auf (minViews 1).
• Eine Meta-Anzeigensuche mit websiteIds listet die eigenen Anzeigen der Shops auf: jede Anzeige der Hauptseite eines Shops und seiner offiziellen Seiten mit ähnlichem Namen sowie die Anzeigen seiner anderen Seiten (Creator, Publisher und Partner, die seine Anzeigen geschaltet haben), die auf den Shop oder eine Website unter seiner Domain verlinken; bis die Liste bis zum Ende gelesen ist, ist pagination.total der Suche dann die Zahl der Anzeigen der durchsuchten eigenen Seiten des Shops, eine Schätzung (pagination.totalEstimated true), oder null, wenn die Suche keine seiner eigenen Seiten nennt.
• Mit sortBy=longestRunning wird jeder von der Datenquelle gelesene Batch von Anzeigen nach daysRunning geordnet.
• In GET /v1/shops/{shopId} zählt advertising.activeAds die laufenden Anzeigen der eigenen Seiten des Shops (linkedAdvertisers[].isOwnPage), und in seinen /products hat ein eingestufter Bestseller Titel, Preis und Bild aus catalog.bestSellers (der Preis eines Bestsellers kann der niedrigste seiner Varianten sein).
• traffic.monthlyVisits (und growth30d) eines Shops ist null mit not_measured, wenn es 0 lautet, weil sein Verlauf neben einer Umsatzschätzung über 0 und verkauften Einheiten auf 0 gefallen ist, in Datensätzen, aufgelisteten und ähnlichen Shops und im Lookup; eine solche Domain ist weiterhin extra.storeWide.
• In GET /v1/ads/{adId} ist advertiser.totalReach die letzte Messung von pageAnalytics.reachHistory, solange diese Messung höchstens 2 Tage alt ist (extra.pageRecordReach enthält dann die Summe des Datensatzes), extra.advertiserTotalAds wird aus den aufgelisteten Werten der Seite befüllt (not_measured ohne einen solchen Wert), die Reichweitengewinne über 7 und 30 Tage einer innerhalb des Zeitfensters gestarteten Anzeige sind ihre gesamte Reichweite, und ein Gewinn unter dem über weniger Tage ist null (not_measured).
• statistics.ctaCount eines Marken-Trackers benennt jeden Call-to-Action so wie content.callToAction (»Shop now«).

Ebenfalls geändert am 21. Oktober 2026 (Shops):

• In GET /v1/shops/{shopId} ist advertising.history in jedem Tarif die Zahl der laufenden Anzeigen der Hauptseite pro Tag (in Free zählte es die aller Seiten), und die Dokumentation sagt, dass Reichweite und Ausgaben in advertising.summary, extra.adsLaunched30d, extra.totalAds und extra.estimatedSpendUsd alle Seiten des Shops abdecken, während advertising.activeAds seine eigenen Seiten zählt.
• Ein catalog.productsCount von 0 ohne aufgelistetes Produkt neben Besuchen, einer Umsatzschätzung oder verkauften Einheiten ist null mit not_measured, in Datensätzen, aufgelisteten Shops und in meta.productsCount von GET /v1/shops/{shopId}/products; sortBy=productsCount lässt diese Shops weg und sendet mit order=asc minProductsCount 1, sofern kein Mindestwert für Produkte angegeben ist.
• Eine Meta-Anzeigensuche eines Shops, die auf Seiten eingegrenzt ist, die nicht seine eigenen sind (trackedPages), und früh endet, nennt den Grund in meta.warnings, ohne zum Eingrenzen aufzufordern.
• GET /v1/filters/shops meldet in meta.warnings, wenn die Datenquelle keine Werte auflistet, und nennt die Listen, die sie liefern.

Ebenfalls geändert am 21. Oktober 2026 (Paginierung, E-Mails und Anzeigenlisten):

• Das Blättern in einer Werbetreibenden-Suche schlägt nicht mehr fehl, wenn die Datenquelle sie nicht fortsetzt (es antwortete mit 503, und ein erneuter Versuch half nicht): Die ersten 100 Ergebnisse werden in einem Aufruf gelesen, und die Seite, die das Ende des Lesbaren erreicht, antwortet mit hasMore false, mit meta.partial true und einer Warnung, die sagt, wie weit die Suche liest.
• Eine Seite, die hinter dem exakten total einer Suche beginnt, ist leer, mit hasMore false.
• Eine TikTok-Suche, sortiert nach views oder likes mit order=asc, beginnt bei den ersten TikToks (31. August 2016, 22:00 UTC), wie longestRunning, und metrics.views (und engagementRate) eines TikTok-Elements ist null mit not_measured, wenn es weniger Aufrufe als Likes angibt.
• content.bodyPreview und bodyLength einer E-Mail sowie content.body eines Datensatzes sind null mit not_measured, wo die Datenquelle ihren Platzhalter für einen nicht gelesenen Text gesendet hat.
• Datums- und Zeitangaben, die die Datenquelle in UTC liefert, werden in Listen und Datensätzen gleich geschrieben, mit +00:00 und ohne nachgestellte Nullen im Sekundenbruchteil (2026-09-30T00:20:11.507+00:00; die Zeitpunkte, zu denen Ihre eigenen Boards, Favoriten, Marken-Tracker und Freigabelinks erstellt oder geändert wurden, enden wie bisher auf Z), und E-Mail-Zeilen enthalten die IDs ihrer Kategorie, ihres Aktionstyps und ihres Ereignisses, wie der Datensatz der E-Mail.
• Jede paginierte Liste liefert pagination.hasMore, und GET /v1/google-ads/facets/countries liefert ein Objekt pagination.
• Ein Anfragetext, der kein gültiges JSON ist, liefert 400 validation_failed mit der Meldung »The request body is not valid JSON.« und details.position, dem Zeichen, an dem er abbricht.
• In Meta-Anzeigenlisten ist die Reichweite einer Zeile die Messung des Anzeigenindex, die einen Tag hinter dem Datensatz der Anzeige liegen kann, und ihre Reichweitengewinne sind neben einer bekannten Reichweite null, wenn die Datenquelle keine auflistet (not_measured), außer über ein Zeitfenster, in dem die Anzeige gestartet ist, wo sie die gesamte Reichweite gewonnen hat, die ihre Zeile angibt; in GET /v1/ads/{adId} hat ein Gewinn, der neben einer bekannten Reichweite null ist, ebenfalls not_measured.

Geändert am 22. Oktober 2026 (der Tarif Free):

• Die API und der MCP-Server wurden in die kostenpflichtigen Tarife verlegt: Ein Schlüssel eines Kontos im Tarif Free lieferte bei jedem Endpunkt außer GET /v1/account 403 plan_not_eligible, mit details.upgradeUrl, und nichts wurde gezählt. Im Tarif Free konnte kein Schlüssel erstellt werden.
• Der Tarif Free hat sich seitdem geändert: Der Tarif Free sagt, was er jetzt umfasst.
• Ein in einem kostenpflichtigen Tarif erstellter Schlüssel bleibt erhalten und funktioniert wieder, sobald das Konto wieder in einem kostenpflichtigen Tarif ist. Freigabelinks, die ein Konto im Tarif Free erstellt hat, werden auf dieselbe Weise pausiert.

Ebenfalls geändert am 22. Oktober 2026 (Shop-Berichte und -Datensätze):

• In GET /v1/shops/{shopId}/ad-ranking/series ist rankDelta der Endrang minus der Startrang (negativ, wenn die Anzeige aufgestiegen ist, wie bei jeder Anzeige; es waren die gewonnenen Plätze), und improvementPercent heißt jetzt improvementPct, ein Bruchteil; jede Zeile von /ad-ranking enthält dieselben beiden Werte über das Zeitfenster des Rankings in rank.
• In /activity/calendar einer verfolgten Marke, einem Kalendertag und /activity/calendar/days ist meta.partial true oder false, meta.partialSources nennt die teilweise gelesenen Quellen (bei /calendar und einem Tag), und Vorschauzeiten sind UTC, auch die eines TikTok-Posts.
• In GET /v1/shops/{shopId}/landing-pages/detail greift activeAds auf die Anzeigen der Seite zurück, shareOfAds ist linkedAdsTotal von shopActiveAds, snapshots zählt die Tage, an denen die Seite erfasst wurde, lifetimeAds und impressions entfallen (die Impressionen waren noch einmal die Reichweite), eine Reichweite von 0 ist null mit nullReasons.reach no_eu_reach, und linkedAds haben die Felder der Zeilen einer Anzeigensuche.
• Der /feed eines Shops listet seine eigenen Meta-Anzeigen auf, wie seine Anzeigensuchen.
• GET /v1/market/q4-overview nimmt beliebige Werte für from und to innerhalb der Saison an.
• In /q4-season listet winners den Schlüssel jedes Sales mit seinen Creatives auf, und Landingpage-URLs enthalten ihr Schema.
• Die Shopify-Detektoren lesen einen Shop unter seiner Domain ohne www..
• GET /v1/advertisers/{advertiserId} sowie die Landingpages, die Zielgruppe und der Medienmix einer verfolgten Marke geben einen vergangenen Tag in meta.snapshotDate zurück.
• Wenn die Meta-Anzeigenstatistiken eines Shops in diesem Moment nicht gelesen werden können, antwortet GET /v1/shops/{shopId} mit meta.partial true und einer Warnung: Seine Reichweite, die daraus abgeleiteten Ausgabenschätzungen und sein Medien- und Formatmix sind null mit nullReasons failed, seine Anzeigen nach Land werden so gezählt, wie seine Suchzeile sie angibt, und die Antwort wird nicht gespeichert, sodass der nächste Aufruf sie erneut liest (das Wettbewerber-Briefing enthält dasselbe meta.partial und dieselben Warnungen).
• Eine Landingpage auf der eigenen Domain des Shops oder einer Subdomain davon ist toShop true in /v1/shops/{shopId}/advertisers und /advertisers/{advertiserId}/landing-pages; wenn die Domains des Shops diese Domain auslassen, listet meta.domains sie aus den Landingpages seiner Seiten zuerst auf (fromLandingPages true, eine Untergrenze), und das shopAds einer Seite liegt nie unter den laufenden Anzeigen ihrer Landingpages auf dem Shop (shopAdsAtLeast true, wenn angehoben).
• In GET /v1/tiktok/library/{itemId} ist profile.latestPosts[].mediaUrl das Video des Posts oder null mit nullReasons not_reported (es war das Titelbild).
• Eine Werbetreibenden-Suche liest ihre ersten 100 Ergebnisse und meldet ihr Ende auf der Seite, die das 100. erreicht (hasMore false und die Warnung), nicht auf der leeren Seite danach.
• Eine TikTok-Suche, sortiert nach views oder likes mit order=asc, lässt jetzt die Posts weg, deren Aufrufe nicht gezählt sind (weniger Aufrufe als Likes), und ihr pagination.total ist eine Schätzung (totalEstimated), bis die Liste bis zum Ende gelesen ist; jede andere Reihenfolge listet sie auf, mit Aufrufen null.

Ebenfalls geändert am 22. Oktober 2026 (gespeicherte Elemente und Anzeigen-Hooks):

• Neu: GET /v1/boards/search findet, was Sie gespeichert haben, über alle Boards und Ihre Favoriten hinweg, anhand der Wörter dessen, was jede gespeicherte Kopie zeigt (jedes Wort muss vorkommen, in beliebiger Reihenfolge; Groß- und Kleinschreibung sowie Akzente werden ignoriert), ihrer ID oder des Namens ihres Boards, und nimmt sourceType, boardId, savedFrom und savedTo an; es liest nur Ihre gespeicherten Elemente, nie die Datenquelle (MCP find_saved_items).
• Neu: POST /v1/tools/ad-hooks schreibt drei kurze Einstiegszeilen für eine Anzeige Ihres Produkts, und GET /v1/tools/ad-hooks gibt Ihr Kontingent an: kein Monatslimit in kostenpflichtigen Tarifen und ein Limit pro Minute (429 mit Retry-After); das Abfragen des Kontingents wird nicht gezählt (MCP write_ad_hooks).
• Der MCP-Server hat 64 Tools.

Ebenfalls geändert am 23. Oktober 2026 (gespeicherte Ansichten und Shop-Filter):

• Neu: GET /v1/views listet die Suchen auf, die Sie auf den Listenseiten der Website gespeichert haben, jeweils mit der Suche, die sie ausführt (request: Suche, searchType, sortBy, order und benannte Filter, so wie die Such-Endpunkte sie annehmen); POST /v1/views speichert eine, PATCH /v1/views/{viewId} benennt sie um, verschiebt oder ändert sie, und DELETE /v1/views/{viewId} entfernt sie. Sie lesen und schreiben nur Ihre eigenen Ansichten, nie die Datenquelle (MCP list_saved_views).
• Shop-Suchen nehmen excludeCurrencies (Währungscodes wie EUR), socialNetworks (instagram oder tiktok: ein Shop mit einem davon) und shopifyPlan (headless) an. trafficGrowth liest auch 90 Tage (min90, max90) und adsGrowth 7 Tage (min7, max7), oder den period einer Regel (last90d, last7d); min und max bleiben die letzten 30 Tage.
• Der MCP-Server hat 65 Tools.

Ebenfalls geändert am 23. Oktober 2026 (Produktlinks):

• In GET /v1/shops/{shopId} enthält jeder Eintrag von catalog.bestSellers handle und productUrl, die Seite des Produkts auf der eigenen Website des Shops: die Adresse, die die Datenquelle angibt, wenn sie auf der Domain des Shops (oder einer Subdomain davon) oder seiner myshopify-Domain liegt, sonst https://<domain>/products/<handle>, wenn sein Handle bekannt ist, sonst null.
• In GET /v1/shops/{shopId}/products folgt productUrl derselben Regel, sodass eine Adresse auf einer anderen Website nicht mehr angegeben wird, und handle ist null, wenn es kein einzelner Teil einer Adresse ist.

Ebenfalls geändert am 23. Oktober 2026 (Shop-Zeilen, ähnliche Shops und Produkte):

• Das createdAt eines Shops (Shop-Datensatz, Shop-Zeilen und ähnliche Shops) ist nur bei einem Shopify-Shop das Erstellungsdatum. Bei einer Website außerhalb von Shopify gibt die Datenquelle den Tag an, an dem sie mit der Erfassung der Website begann, nicht deren Erstellung: createdAt ist jetzt null (nullReasons tracking_date), und dieser Tag ist das neue trackedSince. Ein Datum am oder vor dem 1. Januar 2000 ist der Platzhalter der Datenquelle und ist null (not_reported).
• Die catalog.bestSellers von Shop-Zeilen enthalten handle, productUrl (nach der Regel des Shop-Datensatzes) und rank (1 ist der Bestseller), und Zeilen enthalten profile.isHeadless und catalog.myShopifyDomain, wie der Shop-Datensatz.
• Das googleAds.reach.value einer Shop-Zeile ist null: Shop-Zeilen enthalten keine Google-Reichweite, die steht im Shop-Datensatz (extra.googleAds.reach).
• Ähnliche Shops (GET /v1/shops/{shopId}/similar, die similarShops des Datensatzes) behalten ihr extra (Logo, Trustpilot, Umsatzverlauf). Eine Ähnlichkeitsliste, die die Datenquelle vor ihrem Ende abbricht, liefert meta.partial und eine Warnung auf der Seite, die diesen Punkt erreicht.
• In GET /v1/shops/{shopId}/products waren createdAt und publishedAt die eigene Uhrzeit des Shops, als UTC gesendet (8 Stunden zu früh bei einem Shop in der US-Pazifikzeit). Sie sind jetzt UTC, zusammen mit dem neuen updatedAt, berechnet aus dem Versatz des Shops gegenüber UTC (meta.shopUtcOffset, etwa -08:00). Wenn kein Versatz gelesen werden kann, sind die drei null (local_time), und createdAtLocal, publishedAtLocal und updatedAtLocal geben die Uhrzeit des Shops an, ohne Zeitzone.
• Ein Produkt, das nur unter den Bestsellern in den Shop-Details aufgeführt ist, hat publishedAt und updatedAt null (not_reported): Die Werte der Datenquelle waren Kopien seiner Erstellungszeit.
• Jedes Produkt sagt, in welchen Listen es steht (lists: bestSellers, newest), und seinen Platz unter den meistverkauften (listPosition, 1 bis 100).

Ebenfalls geändert am 23. Oktober 2026 (Shop-Datensätze):

• In GET /v1/shops/{shopId} war extra.googleAds.reach.value immer null: Es ist jetzt die Google-EU-Reichweite des Shops, mit lowerBound und upperBound, und extra.googleAds ergänzt reachHistory, history (seine als aktiv markierten Google-Anzeigen pro Woche), updatedAt und latestAds.
• Das growth30d eines sozialen Netzwerks ist jetzt die 30-Tage-Veränderung der Follower-Übersicht (bei einigen Facebook-Seiten war es ein anderes Zeitfenster: 0,3636, wo die Veränderung 0,2898 betrug). GET /v1/shops/{shopId}/socials gibt sie ebenfalls als growth30d an.
• Das X-Profil des Shops ist socials.x. socials.twitter wird in socials.x umbenannt und bleibt als dasselbe Objekt noch für ein Release erhalten. Jedes Netzwerk hat url, und socials.others listet die anderen Links des Shops auf.
• tiktok.profileMetrics.percentAds ist ein Prozentwert (0 bis 100); das neue adsShare ist derselbe Wert als Bruchteil. tiktok ergänzt avatarUrl, history, postsChange30d, postsChange30dPct und latestAds, und tiktok.activity.avgActiveAds7d und avgActiveAds30d, zuvor null, mitteln seine TikTok-Anzeigen pro Tag.
• Neu in kostenpflichtigen Tarifen: advertising.summary.firstAdSeenAt, longestRunningDays, medianRunningDays, landingPagesCount und die 30-Tage-Veränderungen der laufenden Anzeigen, gestarteten Anzeigen und EU-Reichweite (activeAdsChange30d, launchedChange30d, reachChange30d, jeweils auch als Bruchteil, …Pct) sowie advertising.runningDaysMix, reachCountries, reachHistory, topLandingPages, adsByAgeRange und adsByGender. In jedem Tarif: advertising.allPagesHistory und advertising.topCountries[].ads.
• Neu: catalog.bestSellers[].rank, sales.hasSubscription, technology.apps[].appStoreUrl und categories, profile.isHeadless, extra.updatedAt sowie createdAt und trackedSince der oben beschriebenen Shop-Datumsangaben.
• GET /v1/shops/{shopId}/advertisers ergänzt logoUrl und moreLandingPages jeder Seite, eine profileUrl, wo die Anzeigenübersicht keine hat, sowie landingPagesCount und moreLandingPages jeder Domain.

Ebenfalls geändert am 23. Oktober 2026 (Produkte):

• Neu: GET /v1/products und POST /v1/products/query durchsuchen und durchstöbern Shop-Produkte, jeweils mit Preis, Umsatzschätzungen, verkauften Einheiten, Bewertungen, Bestseller-Rang, Meta-Anzeigen, EU-Reichweite und -Ausgaben, Verkaufsländern, Startdatum und Shop, sortiert nach relevance, newest (Startdatum), activeAds oder spend (EU-Werbeausgaben der letzten 30 Tage) (MCP search_products). searchType gleicht den Text mit dem Namen des Produkts oder der Domain seines Shops ab, und die benannten Filter begrenzen den Preis in USD, die aktiven Anzeigen, den Anzeigenanteil, die Anzahl der Bewertungen und den Starttag und nehmen Währungen und Abonnement an; GET /v1/filters/products listet die Währungen auf, die sie annehmen.
• shop (die Domain oder ID eines Shops) listet nur die Produkte dieses Shops auf, ohne Suchtext daneben, in der Produktsuche und in search_products. Boards speichern Produkte (sourceType product) so, wie eine Suche sie zuletzt gezeigt hat, und die Suche über alles Gespeicherte findet sie über ihren Titel und Shop.
• Der MCP-Server hat 73 Tools.

Ebenfalls geändert am 23. Oktober 2026 (Produktfilter):

• Die Produktsuche nimmt weitere benannte Filter an: die Umsatzschätzung eines Monats oder eines Tages (minEstMonthlySales, minEstDailySales und ihre Höchstwerte; eine Tagesgrenze wird als 30 Tage davon gerechnet), verkaufte Einheiten pro Monat oder Tag (minUnitsSoldMonthly, minUnitsSoldDaily), sellingCountries (ein Produkt, das in eines davon verkauft), shopCountries, die Bewertungsnote (minRating, maxRating), minAdsLaunched (in den letzten 30 Tagen gestartete Meta-Anzeigen), minSpendShare, minEuReach (die EU-Reichweite über 30 Tage), hasPartnershipAds, promoTypes (Prozentrabatt) und minShopProductsCount, jeweils mit seinem Höchstwert, wo es einen gibt; GET /v1/filters/products listet auch die Länder der Shops auf.
• sortBy nimmt estSales (die Umsatzschätzung), adPressure (den Anzeigenanteil) und bestSelling (den Bestseller-Rang in seinem Shop, Rang 1 zuerst) an, und searchType nimmt productDescription und url an.
• Jedes Produkt hat seine neuesten Anzeigen (advertising.latestAds, mit ihren Bildern in advertising.previewUrls) und seine Wochen (weeks: laufende Anzeigen, Anzeigenanteil, EU-Ausgaben und Reichweite pro Tag), und bestSeller.rankPercent ist sein Rang als Prozentsatz der Produkte des Shops (niedrig ist besser).

Geändert am 24. Oktober 2026 (Parameter, fehlgeschlagene Lesevorgänge und tiefe Seiten):

• Ein Query-Parameter, den eine Route nicht liest, wird mit 400 validation_failed abgelehnt, dessen Meldung ihn nennt und die Parameter auflistet, die die Route annimmt, während er früher stillschweigend verworfen wurde (ein falsch geschriebener Name oder ein Filter, der an eine Route ohne Filter gesendet wurde, wurde beantwortet, als wäre er nie gesendet worden). Suchen lehnen einen unbekannten benannten Filter wie bisher ab. Ein einfacher Parameter (country, mediaType, active, type), der einen Filter, den auch ein benannter Filter setzt, auf einen anderen Wert setzt, wird ebenfalls abgelehnt.
• Marken-Tracker: /ads und /timeline/metadata lehnen ein vergangenes snapshotDate ab (sie lesen die Anzeigenbibliothek so, wie sie jetzt ist), /partnership-ads ein unbekanntes sortBy, /v1/workspace/scaling-ads einen unbekannten period, und die Tracker-Liste ein hasNewAdsSince, das mehr als 30 Tage zurückliegt (die Zähler für neue Anzeigen umfassen 30 Tage). /v1/workspace/hooks, /ad-copies und /landing-pages lesen die Zeilen jeder Marke in der angefragten Sortierung (sortBy) und Reihenfolge (order), bevor sie sie zusammenführen. Die markenübergreifenden Berichte der Website senden euOnly nur an die Berichte, die es lesen.
• Ähnliche Shops lehnen displayInTrending in filters ab (die Liste hat kein Shop-Index-Flag) und lesen ihre Wachstumsgrenzen als Prozentwerte, wie eine Shop-Suche; ein offset jenseits dessen, was eine Anfrage lesen kann (600 Shops über die bereits gelesenen hinaus), wird mit einem 400 abgelehnt, das sagt, wie tief es gehen kann, und eine Seite, in der der Lesevorgang endete, hat meta.partial mit einer Warnung. Die TikTok-Bibliothek eines Shops lehnt Profil- und Website-Filter ab (der eigene Bereich des Shops tritt an ihre Stelle).
• Ein Teil einer Antwort, den die Datenquelle diesmal nicht lesen konnte, setzt meta.partial mit einer Warnung (und die Antwort wird nicht zwischengespeichert), nie eine stille Lücke oder eine leere Liste; eine Antwort der Datenquelle, die kein JSON ist, ist ein 503 upstream_error, und ein gespeicherter Shop, ein neuer Tracker oder eine E-Mail-Optionsliste, deren Lesen fehlschlägt, liefert den Fehler, nie not_found. Eine Seite, die tiefer liegt, als ein Lesevorgang einer Liste reicht, die Zeilen auslässt, hat meta.partial und hasMore true, und die Anzeigentexte, Partner und Creative-Tests einer Marke melden mit meta.partial, wenn ein Lesevorgang die Marke nicht abdeckt.
• GET /v1/google-ads/facets/networks nimmt search, limit und offset an, wie die anderen Optionslisten. metric von /v1/shops/compare ist erforderlich (die Referenz nannte es optional).
• MCP: Ein Tool lehnt ein Argument ab, das seine gewählte Art nicht liest (shop_report, lookup_filter_ids, market_overview, scan_advertiser), sowie Argumente, die sich widersprechen (trend_signal mit sort_by, active_only mit status, ein benanntes Argument mit filters); creative_inspiration_pack ordnet die Anzeigen aller Keywords gemeinsam.

Ebenfalls geändert am 24. Oktober 2026 (Bildersuche):

• Neu: POST /v1/products/image-search findet die Shop-Produkte, die einem Bild ähneln, jeweils mit ihrem Shop, die ähnlichsten zuerst. Senden Sie das Bild als multipart/form-data: eine PNG-, JPG- oder WEBP-Datei von höchstens 10 MB (image) oder eine direkte Bild-URL (imageUrl), die wir selbst herunterladen. Jede Zeile ist eine Produktzeile, wie die Produktsuche sie liefert, mit similarity (0,7 bis 1) und matchOnly (ein Treffer, zu dem der Produktindex keinen Datensatz hat: nur Titel, Bild, Preis, Startdatum und Shop).
• Die Suche nimmt die benannten Filter der Produktsuche an, sortBy (relevance, estSales, activeAds, adPressure, newest, spend, spend14d) und maxPerShop (die 1, 3, 5, 10 oder 20 ähnlichsten Treffer jedes Shops), in Seiten von bis zu 32. GET /v1/products/image-search/{searchId} liest ihre weiteren Seiten, Sortierungen, Filter und Ergebnisse pro Shop, ohne das Bild erneut zu senden, und GET /v1/products/image-search/history listet Ihre eigenen letzten Bildersuchen auf.
• Das Bild wird vor der Suche neu geschrieben, als JPEG ohne seine Metadaten (EXIF, Standort, Kommentare), und eine Bild-URL verlässt nie unsere Server. Neue Fehler: 400 invalid_image, 400 unsupported_url und 422 unreadable_image.
• Im Tarif Free wird die Bildersuche nach Relevanz geordnet, ohne Filter. Der MCP-Server hat 67 Tools: search_products_by_image ist neu.

Geändert am 25. Oktober 2026 (Credits):

• Die API und der MCP-Server werden in Credits statt in Anfragen abgerechnet: 1 Credit = 1 zurückgegebenes Ergebnis: die Details einer Marke, eine Anzeige oder eine Zeile einer Liste. Ein leeres Ergebnis ist kostenlos. Ein Aufruf kostet so viele Credits, wie er Ergebnisse liefert, und das monatliche Kontingent der Tarife wird in Credits angegeben.
• Abgerechnete Antworten senden X-Usage-Cost, X-Credits-Used, X-Credits-Remaining und X-Credits-Source; GET /v1/usage meldet die aufgeladenen Credits unter credits.topup.balance.
• 402 insufficient_credits kommt, sobald sowohl die Credits des Monats als auch die aufgeladenen Credits aufgebraucht sind, mit details.upgradeUrl und details.topUpUrl.
• Das Ratenlimit gilt gemeinsam für den ganzen Arbeitsbereich.

Freigabelinks (shareUrl) öffnen eine Webseite auf https://sellwinners.com, die jeder ansehen kann. Derselbe Datensatz ist als JSON über /v1/shared/ads/{token} und /v1/shared/boards/{token} verfügbar. Ein Link, dessen Inhaber im Tarif Free ist, liefert 403 forbidden, bis der Inhaber wieder in einem kostenpflichtigen Tarif ist.

Die Identitäts-Endpunkte /v1/me, /v1/usage und /v1/workspace liefern ihre Objekte auf oberster Ebene, neben requestId. Die System-Endpunkte /v1, /v1/health und /v1/system/freshness enthalten keine requestId, und /v1 und /v1/health liefern ein einfaches Objekt ohne data. Die Request-ID wird auch im Header X-Request-Id gesendet. Geben Sie sie an, wenn Sie den Support kontaktieren.

Boards, Favoriten und Marken-Tracker haben auch Endpunkte für POST, PATCH und DELETE. Sie nehmen einen JSON-Body an, gesendet mit Content-Type: application/json.

Paginierung

Listen-Endpunkte nehmen limit an (bis zu 100 bei Suchen; Facetten-Listen nehmen bis zu 500 und die /snapshots einer Marke bis zu 365) sowie entweder page (1, 2, 3 …) oder offset. Wenn beide gesendet werden, wird offset verwendet. Die Standard-Seitengröße steht bei jedem Endpunkt. Listen von Anzeigen, Google-Anzeigen, TikTok, E-Mails und Medien antworten mit:

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

Listen von Shops, Produkten und Werbetreibenden sowie die Anzeigen eines Werbetreibenden antworten mit:

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

Für die nächste Seite wiederholen Sie dieselbe Anfrage mit page plus eins oder mit offset plus limit. In einem Body von POST …/query senden Sie "page" oder "offset" als Felder. hasMore ist auf der letzten Seite false. Wenn die Datenquelle eine Suche ab einem bestimmten Punkt nicht fortsetzt, antwortet die Seite, die ihn erreicht, mit hasMore false, mit meta.partial true und einer Warnung, die sagt, wie viele Ergebnisse gelesen werden können. Die Paginierung reicht bis zu den ersten 5.000 Ergebnissen einer Suche (bei einer Werbetreibenden-Suche bis zu den ersten 100). Grenzen Sie die Suche mit Filtern ein oder ändern Sie die Sortierung, um andere Ergebnisse zu sehen.

Listen von Google-Anzeigen liefern ein exaktes total, außer bei einer Liste, die die Regel für Status oder Tage aktiv eingrenzt (siehe die Suche nach Google-Anzeigen). Ein "totalEstimated": true markiert ein total (und sein totalPages), das eine Schätzung ist, bis die Liste bis zum Ende gelesen ist, wie bei den ähnlichen Shops eines Shops und einer Meta-Anzeigensuche eines Shops (websiteIds).

Boards, Favoriten und Berichte des Marken-Trackers nehmen page und limit an und antworten mit page, limit, total, totalPages und hasMore. Facetten-Listen, die /products eines Shops und seine /similar-Shops nehmen limit und offset an und antworten mit limit, offset, total und hasMore.

Sortierung & Filter

Such-Endpunkte akzeptieren sortBy und order (standardmäßig desc). Wenn Sie einen Suchbegriff angeben, werden die Ergebnisse nach relevance sortiert, sofern Sie keine andere Sortierung wählen; ohne Suchbegriff ist der Standard newest (Shops und Produkte: relevance, Medien: reach). Suchen nach Google- und TikTok-Anzeigen werden immer nach Relevanz geordnet; dort gilt sortBy, wenn Sie ohne Suchbegriff stöbern.

Jeder Datenbestand hat einen Endpunkt POST …/query, der für erweitertes Filtern einen JSON-Body mit query, filters, sortBy, order, limit und page (oder offset) annimmt. Nutzen Sie die Facetten-Endpunkte, um die Werte und IDs zu sehen, die die Filter annehmen.

Filter können nach Name gesendet werden: als zusätzliche Query-Parameter bei einer GET-Suche (?status=active&minDaysRunning=30&mainCountries=US,GB) oder als Felder auf oberster Ebene eines Bodys von POST …/query ({"status": "active", "minDaysRunning": 30}). Jeder Endpunkt unten listet die Namen auf, die er annimmt. Bei den Such-Endpunkten liefert ein Filtername, den der Endpunkt nicht unterstützt, ein 400 validation_failed, das die unterstützten auflistet, sodass ein Tippfehler nie stillschweigend ungefilterte Ergebnisse liefert; die Berichte des Marken-Trackers ignorieren Namen, die sie nicht kennen. Listen nehmen kommagetrennte Werte oder ein JSON-Array an, Datumsangaben verwenden 2026-01-31, und das rohe Objekt filters funktioniert weiterhin neben benannten Filtern.

Wachstumsfilter (trafficGrowth, adsGrowth, pageReachGrowth, adReachGrowth) nehmen Regeln an, die als {"comparison": "greater" | "lower", "value": 50} oder {"operator": "gte" | "lte", "value": 50} geschrieben werden. Die Werte sind Prozentsätze über die letzten 30 Tage; andere Zeiträume sind nicht verfügbar. minRankDelta ist die Mindestzahl an Positionen, die eine Anzeige über rankDeltaWindow gewonnen hat (7d, sofern Sie nicht 14d oder 30d senden). hideSavedAds lässt die Anzeigen weg, die Sie bereits gespeichert haben. Kategorie-IDs für jeden Filter categoryIds stammen aus /v1/facets/categories.

Ratenlimits & Credits

1 Credit = 1 zurückgegebenes Ergebnis: die Details einer Marke, eine Anzeige oder eine Zeile einer Liste. Ein leeres Ergebnis ist kostenlos. Jeder Tarif enthält Credits für den Monat, die am 1. um 00:00 UTC erneuert werden. Ein Aufruf kostet so viele Credits, wie er Ergebnisse liefert, ein kleineres limit kostet also weniger, und ein MCP-Tool-Aufruf kostet wie die API so viele Credits, wie er Ergebnisse liefert. Credits und das Ratenlimit gelten pro Arbeitsbereich: Alle Mitglieder, alle seine Schlüssel, die API und der MCP-Server teilen sich ein Credit-Kontingent und ein Ratenlimit. In einem kostenpflichtigen Tarif kann der Inhaber des Arbeitsbereichs auf der Abrechnungsseite Credits aufladen (für €1 erhalten Sie 120, ab €10): Aufgeladene Credits werden nach den Credits des Monats verbraucht, in den Folgemonat übertragen und verfallen nie.

Jede abgerechnete Antwort enthält:

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

Über dem Ratenlimit pro Minute erhalten Sie 429 rate_limited mit einem Header Retry-After (in Sekunden). Wenn sowohl die Credits des Monats als auch die aufgeladenen Credits aufgebraucht sind, erhalten Sie 402 insufficient_credits, mit details.upgradeUrl und details.topUpUrl, bis die monatlichen Credits erneuert werden. Prüfen Sie Ihre Credits jederzeit mit GET /v1/account oder GET /v1/usage. Diese Aufrufe kosten nichts, senden trotzdem X-Usage-Cost: 0, X-Credits-Used: 0 und X-Credits-Remaining und funktionieren auch, wenn die Credits aufgebraucht sind.

Diese Limits gelten für die API und den MCP-Server, in kostenpflichtigen Tarifen und in Free. Die Web-App auf der Website wird nicht abgerechnet: In kostenpflichtigen Tarifen ist sie im Rahmen der fairen Nutzung unbegrenzt.

Der Tarif Free

Der Tarif Free umfasst die Web-App und den MCP-Server (150 Credits pro Monat), ohne die API. Ein Free-Konto erstellt in seinem Dashboard einen Schlüssel für den MCP-Server (KI-Agenten), im Rahmen von 150 Credits pro Monat und 10 Anfragen pro Minute; die REST-API gibt es in kostenpflichtigen Tarifen: Mit einem Free-Schlüssel liefert sie 403 plan_not_eligible, mit details.feature, details.requiredPlan und details.upgradeUrl, bei jedem Endpunkt außer GET /v1/account, und nichts wird gezählt. Ein in einem kostenpflichtigen Tarif erstellter Schlüssel wird in Free pausiert und funktioniert wieder, sobald das Konto wieder in einem kostenpflichtigen Tarif ist. In Free liefert eine Suche ihre ersten Ergebnisse, und ein Tool oder Endpunkt, dessen Daten Free nicht umfasst, antwortet mit der Meldung der kostenpflichtigen Tarife. Der Tarifvergleich zeigt, was Free umfasst. Die Demo-Marken sind auf der Website vollständig zugänglich.

Fehler

Fehler verwenden standardmäßige HTTP-Statuscodes und einen JSON-Body:

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

code ist stabil und eignet sich für Verzweigungen in Ihrem Code, message ist für Menschen geschrieben, und details enthält zusätzliche Daten, wenn es welche gibt (die abgelehnten Felder eines 400; die monatlichen Credits, ihr Erneuerungsdatum, upgradeUrl und topUpUrl eines 402).

Medien-URLs

Bilder und Videos in Antworten werden über unser CDN unter https://api.sellwinners.com/v1/media/file/… ausgeliefert. Diese URLs brauchen keinen API-Schlüssel und verbrauchen keine Credits, sodass Sie sie direkt in <img>- und <video>-Tags einbetten können. Eine Datei, die die Datenquelle nicht mehr hat, wird einen Tag lang als null gesendet, und eine fehlende Datei liefert ein leeres 404 ihres Medientyps. Produktbilder und App-Symbole, die im CDN von Shopify liegen, werden ebenfalls über unser CDN ausgeliefert. Um ein Bild klein anzuzeigen, fügen Sie ?w=96 (Vorschaubilder) oder ?w=480 (Karten) hinzu: Ein JPEG-, PNG-, WebP- oder GIF-Bild wird dann als WebP mit höchstens dieser Breite gesendet, nie vergrößert; eine Animation, ein kleineres Bild oder ein Video kommt unverändert. Für eine flache, anzeigefertige Liste von Creatives nutzen Sie /v1/media.

Um ein Bild in Originalgröße, aber leichter anzuzeigen, fügen Sie ?w=full hinzu: Ein JPEG-, PNG-, WebP- oder GIF-Bild wird dann als WebP in seiner eigenen Breite und Höhe gesendet, in einer Qualität, die gleich aussieht, sofern das mindestens ein Zehntel der Datei spart; sonst, und bei einer Animation oder einem Video, kommt das Original unverändert. Ohne w wird die Originaldatei gesendet.

Nachschlagen

Einen Namen, eine Domain oder eine Seiten-ID in die IDs umwandeln, die die anderen Endpunkte erwarten.

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"

Shops

Shopify-Shops finden und ihre Produkte, ihren Traffic, Umsatz, ihre Social-Media-Konten und Anzeigen abrufen.

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

Die Tagessummen des gesamten Markts und seine Q4-Saison.

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-Anzeigen

Anzeigen-Creatives von Facebook und Instagram mit Medien, Reichweite und 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

Anzeigen-Creatives von Google.

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

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

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

TikTok

TikTok-Anzeigen und organische Beiträge.

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"

Medien

Darstellungsfertige Creatives: Bild- und Video-URLs in unserem 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"

Werbetreibende

Werbetreibende (Facebook-Seiten) und ihre Aktivität.

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- und Newsletter-E-Mails von Marken.

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"

Produkte

Shop-Produkte mit Preis, Umsatz, Bewertungen, Anzeigen und EU-Reichweite.

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

Die Werte und IDs, die die Suchfilter erwarten.

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"

Boards

Anzeigen, Shops, Produkte, E-Mails und Werbetreibende in Boards speichern und teilen.

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"

Favoriten

Favorisierte Anzeigen, Shops und E-Mails, in Ordnern.

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

Gespeicherte Ansichten

Die Suchen, die Sie auf den Listenseiten der Website gespeichert haben, nach Seite.

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"

Marken-Tracker

Marken folgen und Berichte über ihre Anzeigen, Creatives und Landingpages lesen.

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