Dokumentasi API data e-dagang

API SellWinners memberi anda maklumat risikan e-dagang dan pengiklanan melalui HTTPS dengan respons JSON: kedai Shopify beserta produk dan trafiknya; produk kedai beserta harga, anggaran jualan, ulasan dan iklannya; iklan Meta, Google dan TikTok; pengiklan; dan e-mel yang dihantar jenama. Setiap endpoint juga tersedia kepada ejen AI melalui pelayan MCP terhos kami. Halaman ini membincangkan pengesahan, format respons, penomboran, pengisihan dan penapis, had kadar dan kredit, ralat dan URL media, kemudian setiap endpoint beserta parameter dan contoh permintaan, dan alat pelayan MCP.

Mula pantas

1. Cipta akaun, sahkan e-mel anda dan pilih pelan berbayar: API dan pelayan MCP bermula di situ.
2. Buka Kunci API dan cipta kunci. Salin segera: ia hanya dipaparkan sekali.
3. Buat permintaan pertama anda:

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

Pengesahan

Hantar kunci API anda pada setiap permintaan dalam pengepala X-API-Key, atau sebagai token bearer:

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

Kunci bermula dengan ak_live_. Rahsiakannya: jangan letakkannya dalam kod bahagian hadapan atau repositori awam. Anda boleh mencipta beberapa kunci (satu bagi setiap apl atau persekitaran) dan membatalkan mana-mana kunci daripada papan pemuka anda; kunci yang dibatalkan berhenti berfungsi serta-merta.

Respons

Setiap respons ialah JSON. Ia membawa requestId dan hasilnya di bawah data: senarai untuk carian dan penyenaraian, satu objek untuk satu rekod. Senarai menambah objek pagination, dan sesetengah jawapan menambah 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 }
}

Rekod ialah objek bersarang: sesuatu iklan mempunyai media, advertiser, content, metrics, audience, rank dan flags, dan kedai, pengiklan, iklan Google, item TikTok dan e-mel dikumpulkan dengan cara yang sama. Nilai yang tidak diketahui ialah null. Medan lain yang tiada tempat tetap disimpan di bawah extra. Contoh di atas dipendekkan.

Dalam sesuatu iklan, content.title ialah tajuk dan content.callToAction ialah teks yang boleh dibaca seperti "Shop now". metrics.estimatedSpend ialah anggaran perbelanjaan daripada sumber data apabila ada (satu iklan daripada /v1/ads/{adId} membacanya), jika tidak capaian x 9 / 1000 (9 USD bagi setiap 1,000 orang yang dicapai); anggaran perbelanjaan mengekalkan dua tempat perpuluhan di bawah 10 USD dan dalam dolar bulat bermula 10 USD ke atas. rank.rankDelta ialah kedudukan semasa tolak kedudukan sebelumnya, jadi nilai negatif bermaksud iklan itu naik, dan rank.improvementPct ialah pecahan (0.25 ialah suku).

Laporan kedudukan penjejak jenama (/ad-rank, /scaling-ads, /v1/workspace/scaling-ads dan alat MCP get_brandtracker_scaling_ads) menambah metrics mereka sendiri: di situ metrics.rankDelta ialah kedudukan sebelumnya tolak kedudukan semasa (positif: tempat yang diperoleh) dan metrics.improvementPct ialah pecahan kedudukan sebelumnya yang diperoleh, seperti dalam sesuatu iklan (0.875 ialah 87.5%). Pada satu iklan, metrics.reachDelta1d, reachDelta7d dan reachDelta30d diisi daripada sejarah capaiannya. Kedai menamakan kategori mereka: catalog.mainCategory dalam senarai, serta catalog.categories pada satu kedai.

Dalam iklan Google, media.type dan media.format ialah text, image atau video, dan media.url ialah imej iklan itu: bagi iklan video, imej kecilnya (tiada fail video). transparencyUrl ialah iklan itu pada Ads Transparency Center Google, tempat iklan video dimainkan; ia ialah null apabila iklan itu tiada id Google. network ialah search, youtube, shopping, maps atau other, begitu juga nilai extra.networks.

Diubah pada 19 Oktober 2026:

• media.format iklan Google dahulunya kod format dan kini ialah text, image atau video, media.type boleh jadi text atau video, dan extra.networks menggunakan nama huruf kecil network.
• media.url Google tidak pernah merupakan fail video, walaupun media.type ialah video.
• Dalam penapis formats Google, image kini bermaksud iklan imej (sebelum ini ia bermaksud iklan teks), jadi gunakan text untuk iklan teks. Kod terdahulu static_image, html5_iframe dan responsive_display, serta nama pendeknya, masih diterima.

status iklan Google ialah active hanya semasa Google memaparkan iklan itu: iklan yang tidak dipaparkan Google lebih daripada 7 hari ialah unknown. daysRunning mengira hari dari firstSeenAt hingga lastSeenAt, kedua-duanya termasuk; extra.servedDays ialah kiraan sumber data itu sendiri, yang berterusan selepas iklan berhenti. Penapis sepadan dengan apa yang ditunjukkan oleh setiap iklan: status=active mengekalkan iklan yang dipaparkan Google dalam 7 hari lepas dan status=inactive iklan yang ditandakan sumber data sebagai berhenti, jadi iklan unknown tidak berada di bawah mana-mana; minDaysRunning dan maxDaysRunning mengekalkan iklan yang nilai daysRunning berada dalam julat. Senarai sedemikian mempunyai pagination.total null, dan apabila hanya sedikit daripada iklan yang dibaca sepadan, ia berakhir lebih awal, dengan meta.partial dan amaran.

Tanpa teks carian, sortBy=relevance menyenaraikan yang terbaharu; sortBy=reach hanya menerima order=desc. Dengan status=active, sortBy=reach menyenaraikan sedikit iklan: dalam susunan capaian, iklan pertama kebanyakannya iklan yang telah dihentikan Google, jadi isih mengikut terbaharu untuk iklan yang sedang dipaparkan Google (amarannya menyatakan perkara ini). Iklan Google tidak menerima sortBy=longestRunning: sumber data menyusunnya mengikut hari yang berterusan selepas iklan berhenti, jadi ia menyenaraikan iklan yang tidak lagi dipaparkan Google, dan ia menjawab 400 dengan sebab itu.

extra.startIsFloor menandakan iklan yang mula dilihat pada 31 Mei 2018, hari pertama data iklan Google, jadi ia mungkin lebih lama. audience.countries menyenaraikan setiap negara audiens, dengan percentage hanya bagi iklan yang dipaparkan di satu negara; remarketing dan interest ialah null apabila tidak diketahui.

Google melaporkan capaian bagi sesetengah iklan yang dipaparkan di EU sahaja, selalunya hanya sebagai 10,000,000, had atas skalanya (10 juta atau lebih): kebanyakan iklan tidak mempunyainya, dan nullReasons menyatakan sebab reach.value ialah null (not_reported: iklan yang dipaparkan di EU yang tidak dilaporkan capaiannya oleh Google; eu_only: iklan yang dipaparkan di tempat lain), kecuali capaian yang ditinggalkan oleh pelan. extra.networks ialah senarai platform iklan daripada sumber data, yang mungkin tidak menamakan network. extra.shop.google memegang jumlah Google bagi laman web pengiklan; bagi laman yang bukan kedai (kedai apl, laman sosial, pemendek pautan) advertiser.domain dan websiteId ialah null.

Diubah pada 20 Oktober 2026:

• Domain (GET /v1/shops/{domain}, carian id, domain TikTok, ringkasan pesaing) ialah laman dengan domain tepat itu, termasuk di luar indeks kedai; domain yang tidak dicapai sumber data dijawab 404.
• GET /v1/lookup menyusun hasil dengan yang terbaik dahulu: laman milik sesuatu domain, halaman Facebook miliknya (halaman utama dahulu), kemudian halaman yang dinamakan seperti domain itu; bagi nama, laman milik jenama dan halamannya sendiri (halaman utama dahulu), kemudian kedai dan halaman yang ditemui melalui nama itu.
• Apabila laman jenama ditemui, kedai atau halaman yang mempunyai nama itu hanya di dalam sesuatu perkataan dikecualikan dan laman dengan nama itu dianggap tepat hanya apabila ia menjalankan iklan; jika tidak, padanan nama dianggap tepat hanya jika ada trafik atau iklan. Halaman rasmi bernama lain yang tiada iklan aktif datang selepas halaman yang ditemui melalui nama.
• Pada baris kedai, signals.activeAdsSource menyatakan dari mana activeAds diperoleh: page (iklan aktif halaman utamanya, dibaca sekarang, pada baris kedai itu sendiri) atau index (kiraan indeks kedai, yang mungkin lebih lama).
• Carian domain kedai (searchType=domain) menyenaraikan laman yang tepat dahulu, dengan extra.exactDomainMatch (dan extra.inShopIndex false apabila indeks kedai tidak memasukkannya).
• Bagi laman yang bukan kedai (kedai apl, laman sosial atau pemesejan, pemendek pautan atau ubah hala penjejakan), extra.domain pada baris pengiklan ialah null, rekod pengiklan menamakannya dalam extra.nonShopSite, meninggalkan extra.platforms dan mengambil linkedShops daripada halaman pendaratannya (fromLandingPages), dan iklan tidak mempunyai shops.
• Tarikh dan masa yang dihantar sumber data tanpa zon ialah UTC dan kini dihantar dengan +00:00.
• Dalam statistik e-mel, emailsByDayOfWeek dikunci mengikut nombor hari: 0 ialah Ahad, 6 Sabtu.
• Baris carian id boleh membawa nullReasons, dan rekod kedai boleh membawa meta.partial apabila angka senaraiannya tidak dapat dibaca.

Turut diubah pada 20 Oktober 2026 (TikTok):

• publishedAt bagi item TikTok ialah UTC. Ia lewat 1 atau 2 jam, jadi siaran yang dibuat pada jam terakhir hari UTC menunjukkan hari berikutnya dan daysRunning kurang satu hari.
• Penapis sepadan dengannya: publishedAfter dan publishedBefore ialah UTC (tarikh sahaja ialah permulaan harinya, dan publishedBefore menyenaraikan siaran sebelumnya), minDaysRunning dan maxDaysRunning mengira dari hari UTC, seperti daysRunning, dan sortBy=longestRunning bermula pada 31 Ogos 2016, 22:00 UTC.

Turut diubah pada 20 Oktober 2026 (iklan Google):

• GET /v1/google-ads, POST /v1/google-ads/query dan alat MCP tidak menerima sortBy=longestRunning (atau daysRunning) dan menjawab 400 beserta sebabnya: sumber data menyusunnya mengikut hari yang berterusan selepas iklan berhenti, jadi ia menyenaraikan iklan yang tidak lagi dipaparkan Google.
• Carian Free yang hasil pertamanya menjadi sedikit selepas ditapis dengan status=active menjawab dengan meta.partial dan amaran yang menyatakan berapa banyak iklan yang dibaca disenaraikannya.
• Dalam extra.shop, laman web tanpa data trafik tidak mempunyai monthlyVisits (sebelum ini 0), trafficGrowth30d hanya disertakan bersama lawatan melebihi 0, dan extra.shop.google tidak memuatkan totalReach atau weeklyReach bernilai 0 (tidak pernah dilaporkan) dan, apabila tiada iklan dikira, kiraan 0 itu.
• Iklan Google yang disimpan ke papan juga dibaca dengan cara yang sama.

Turut diubah pada 20 Oktober 2026 (kedai):

• Dalam GET /v1/shops/{shopId}, advertising.summary.reach30d ialah capaian EU 30 hari lepas, dijumlahkan mengikut tarikh (sebelum ini jumlah sejak penjejakan bermula, kini totalReach), spend30d ialah capaian itu x 9 / 1000, extra.estimatedSpendUsd ialah perbelanjaan sejak penjejakan bermula dan extra.adsLaunched30d menjumlahkan iklan yang dilancarkan dalam 30 hari lepas; semuanya null bagi kedai tanpa capaian EU atau UK.
• Rekod kedai, kedai dalam senarai dan statistik e-mel mempunyai nullReasons, iaitu laluan medan yang dipetakan kepada sebab ia null: not_shopify (jualan dan produk dianggarkan untuk kedai Shopify sahaja), no_estimate, not_measured, eu_uk_only, not_linked (tiada profil TikTok), not_on_tp, no_reviews, none_found.
• Anggaran jualan sifar di samping unit terjual ialah null, dalam rekod, senarai dan sejarah jualan, yang period=week memberikan satu titik bagi setiap minggu.
• traffic.growth30d ialah pecahan (-0.1543 ialah -15.4%), dan traffic.history bermula pada bulan pertama yang ada lawatan.
• catalog.mainCategory datang daripada id kategori (yang paling khusus dalam cabang utama), bersama catalog.categoryLeaves dan productsCountCapped (25,001 ialah had atas sumber data: 25,000 atau lebih).
• Halaman Trustpilot tanpa ulasan mempunyai penilaian null.
• tiktok.matchedBy ialah socials atau handle apabila angka TikTok datang daripada profil sosial kedai atau daripada profil yang ditemui melalui nama penggunanya (padanan, bukan pautan daripada sumber data).
• advertising.mainPageActiveAds ialah iklan aktif halaman utama (bacaan gambaran keseluruhan iklannya, seperti yang ditunjukkan oleh Halaman utama dalam linkedAdvertisers; kiraan yang ditunjukkan senarai kedai hanya muncul apabila bacaan itu tiada) dan linkedAdvertisers[].rank ialah kedudukan halaman itu.
• Kedai serupa tidak termasuk kedai itu sendiri dan laman webnya sendiri, dan setiap halaman diisi daripada senarai yang lebih ke bawah (offset dan limit mengira senarai tanpa kedai-kedai itu).
• Produk yang diisih mengikut populariti meletakkan produk terlaris kedai di hadapan (meta.order).
• E-mel dan statistik e-mel sesebuah kedai mengira setiap jenis kempen, dan angka 90 harinya null apabila tidak diketahui.
• Isihan jualan menyenaraikan satu baris bagi setiap kedai Shopify (extra.sharedSalesWith), dan sortBy=estMonthlySales&order=asc tidak memuatkan kedai tanpa anggaran.

Turut diubah pada 20 Oktober 2026 (angka kedai):

• Isihan jualan GET /v1/shops terus dibaca melepasi domain yang digabungkannya menjadi satu baris bagi setiap kedai Shopify (sebelum ini ia berhenti selepas beberapa baris pertama), turut menggabungkan domain sesebuah kedai yang lebih jauh ke bawah dalam senarai, dan pagination.total ialah null sehingga senarai dibaca hingga ke hujung; sortBy=estMonthlySales&order=asc bermula pada anggaran 100 USD (minMonthlySales 100).
• Anggaran jualan di bawah 0.50 USD bagi setiap unit terjual ialah null (no_estimate), dalam rekod, senarai dan sejarah jualan.
• traffic.monthlyVisits ialah null bagi laman web yang belum diukur dan traffic.growth30d apabila bulan sebelumnya tiada lawatan (not_measured); growth30d sesuatu rangkaian sosial datang daripada sejarah pengikutnya apabila sumber data memberikan 0 atau tiada, dan 0 pengikut ialah null (not_measured).
• Kedai dalam senarai menyatakan sebab catalog.productsCount dan sales.unitsSold ialah null.
• extra.storeWide menandakan domain dengan 0 lawatan yang membawa jualan kedainya (0 yang telah diukur, atau domain lain milik kedai itu, yang dinamakan dalam extra.sharedSalesWith, memiliki lawatan itu; pelan Free tidak menyertakan nama itu dalam rekod kedai).
• advertising.mainPageActiveAds ialah iklan aktif halaman utama seperti yang dibaca oleh gambaran keseluruhan iklannya (kiraan yang ditunjukkan senarai kedai hanya muncul apabila bacaan itu tiada).
• Kedai serupa juga tidak termasuk kedai jenama milik kedai itu, dan extra.similarIndexed ialah false bagi kedai yang tiada dalam indeks kesamaan.
• catalog.mainCategory mengekalkan label asal sumber data hanya apabila ia ialah nama sesuatu kategori.
• Fail media yang dipautkan oleh sesuatu jawapan tetapi sudah tiada pada sumber data membalas 200 dengan badan kosong dan X-Media-Missing: true.

Turut diubah pada 20 Oktober 2026 (pengiklan dan iklan Meta):

• Capaian pengiklan ialah capaian EU dan UK, mengikut tempoh carian pengiklan sendiri: advertising.reach30d, extra.reach14d, reach90d dan totalReach ialah null bagi halaman tanpa iklan EU atau UK dan tanpa capaian, atau bagi tempoh yang belum dikira oleh sumber data, dan nullReasons menyatakan sebabnya (eu_uk_only, not_measured); halaman yang dicipta dalam sesuatu tempoh mempunyai seluruh capaiannya dalam tempoh itu (sebelum ini 0).
• Dalam GET /v1/advertisers/{advertiserId}, capaian ialah yang ditunjukkan senarai pengiklan (sebelum ini dibaca 30 bacaan ke belakang, dan bacaan ada yang melangkau hari), anggaran perbelanjaan ialah null bersama capaian itu, extra.avgSpendUsd14d ialah purata perbelanjaan harian selama 14 hari, extra.avgActiveAds14d ialah purata 14 hari iklan aktifnya (sebelum ini iklan baharunya selama 14 hari), dan jika sumber data belum mengiranya, bagi halaman yang dicipta dalam tempoh 14 hari itu ia dikira daripada iklan aktif yang dibaca sejak hari pertamanya (extra.averagedFrom), jika tidak null, dan kiraan iklan baharu bagi halaman yang dicipta dalam tempoh itu mengira setiap satu iklannya.
• advertising.countryDistribution ialah bahagian iklan aktifnya yang menyasarkan setiap negara (satu iklan boleh menyasarkan beberapa negara), extra.reachCountries memuatkan bahagian setiap negara daripada capaian EU, extra.platforms.meta memuatkan iklan milik halaman itu sendiri (sebelum ini milik halaman utama kedai), kiraan TikTok atau Google tanpa angka tidak disertakan, extra.mainLandingPages menggunakan pratonton halaman pendaratan halaman baharu sebagai ganti, dan lastAds bagi halaman yang iklannya belum diambil oleh carian iklan ialah iklan terkini yang disenaraikan baris pengiklannya, bersama meta.indexing, seperti pada GET /v1/advertisers/{advertiser_id}/ads (bersama meta.liveAds).
• Baharu: GET /v1/advertisers/{advertiserId}/history, iklan aktif halaman itu dan capaian EU yang diperolehnya, hari demi hari.
• Bilangan pengikut Instagram 0 ialah null (sumber data menulis 0 bagi halaman yang tiada akaun yang diketahuinya).
• metrics.reach dan perbelanjaan sesuatu iklan Meta ialah null bagi iklan yang tidak dipaparkan di EU atau UK (eu_uk_only; sebelum ini 0 atau null) dan bagi iklan EU yang capaiannya belum dikira (not_measured; sebelum ini 0), dengan baris media menyatakan sebabnya dalam nullReasons.reach, media.type ialah carousel bagi iklan yang mempunyai lebih daripada satu imej atau video, dan extra.startIsFloor menandakan iklan yang bermula pada 1 Januari 2018, hari pertama bagi tarikh iklan Meta pada sumber data.
• sortBy=adRank menyenaraikan kedudukan terbaik (1) dahulu, walau apa pun susunannya.
• Satu iklan (GET /v1/ads/{adId}) mengambil capaian terkini yang dilaporkan sumber data beserta perbelanjaannya, mengira perubahan capaiannya mengikut tarikh selagi sejarah capaiannya terkini (jika tidak, ia null), menyenaraikan imej dan videonya seperti baris carian, mengisi advertiser.reach30d dan pageAnalytics.instagramFollowersHistory, menambah pageAnalytics.reachHistory (siri yang sama dengan impressionsHistory), dan menamakan kedai yang rekod itu berikan melalui id sahaja (traffic kedai itu ialah null dengan nullReasons shops.traffic apabila laman web itu belum diukur); audience.gender, ageMin, ageMax dan metrics.aggregatedReach sentiasa null, kerana sumber data tidak melaporkannya bagi satu iklan.
• Dalam carian pengiklan, sortBy=reach menyusun mengikut jumlah capaian sejak penjejakan bermula dan newAds mengikut iklan baharu 14 hari.
• Sasaran iklan Meta menentukan sebab capaiannya null: eu_uk_only hanya bagi iklan yang tidak menyasarkan mana-mana negara EU atau UK; iklan yang menyasarkan salah satu daripadanya, atau yang sasarannya belum diketahui, ialah not_measured dalam 7 hari pertamanya dan not_reported selepas itu (sebelum ini eu_uk_only), dalam senarai iklan, baris media dan satu iklan.
• Satu iklan membaca sejarah capaian dan perbelanjaannya sebagai satu siri, satu bacaan sehari (perubahannya juga), dan mengambil bacaan serta perbelanjaan terakhir siri itu apabila capaian rekod lebih daripada dua kali ganda nilainya dan siri itu berlanjutan hingga hari terakhir iklan; media iklan itu menggunakan fail pertama yang disenaraikan sebagai ganti, dan advertiser.totalReach menggunakan capaian EU daripada butiran halaman.
• Rekod pengiklan yang barisnya tidak mempunyai bacaan capaian tetapi butiran halamannya ada, menggunakan capaian butiran itu (extra.totalReach, perbelanjaannya, dan advertising.reach30d yang dikira daripadanya), bahagian dalam extra.reachCountries tidak pernah dibundarkan kepada 0, extra.averagedFrom tidak pernah mendahului hari halaman itu dicipta, dan sejarah hariannya (extra.history, GET /v1/advertisers/{advertiserId}/history) tidak memuatkan bacaan yang terlepas oleh sumber data (urutan sifar sepanjang 14 hari atau kurang antara bacaan melebihi 0).
• Satu iklan yang mengambil bacaan siri menyimpan capaian rekod dalam extra.recordReach (angka yang ditunjukkan senarai iklan); dalam carian pengiklan, baris yang tidak mempunyai bacaan capaian EU tetapi butiran halamannya ada, menggunakan capaian butiran itu, seperti yang dilakukan rekodnya; dan GET /v1/advertisers/{advertiserId}/history kini mengekalkan bacaan 0 bagi halaman yang kini tiada iklan EU tetapi pernah memperoleh capaian sebelum hari yang diminta (dalam hari itu ia tidak memperoleh capaian; sebelum ini bacaan itu ditinggalkan sebagai not_measured).
• Pada pelan Free, iklan yang capaiannya tidak diketahui menyatakan sebabnya seperti pada pelan berbayar; hanya capaian yang tidak termasuk dalam pelan itu yang tiada sebab.

Turut diubah pada 20 Oktober 2026 (anggaran perbelanjaan):

• Anggaran perbelanjaan di bawah 10 USD mengekalkan dua tempat perpuluhan: capaian 140 pada 9 USD bagi setiap 1,000 orang yang dicapai ialah 1.26 (sebelum ini 1), dan purata harian mengekalkan sennya sendiri; dari 10 USD ke atas, anggaran perbelanjaan ialah dalam dolar penuh (capaian 2,000 ialah 18).
• Ini terpakai untuk extra.estimatedSpendUsd dan extra.avgSpendUsd14d pada rekod pengiklan, advertising.summary.spend30d dan extra.estimatedSpendUsd pada kedai, metrics.estimatedSpend pada iklan Meta, serta statistics.euData.estimatedSpend30d dan estimatedSpend bagi setiap titik /time-series pada penjejak jenama (kedua-duanya sebelum ini mempunyai dua tempat perpuluhan pada sebarang jumlah), dalam API dan alat MCP. Jika angka sumber data sendiri ialah anggaran itu dalam dolar penuh, ia mengekalkan sennya dengan cara yang sama.

Turut diubah pada 20 Oktober 2026 (capaian pengiklan dan sejarah harian):

• GET /v1/advertisers/{advertiserId} menambah extra.reachScope: outside_eu_uk bagi halaman yang kebanyakan capaiannya mengikut negara dilihat di luar EU dan UK (sumber data turut melaporkan capaian sesetengah iklan yang dipaparkan di tempat lain; capaiannya dan anggaran yang dibuat daripadanya ketika itu ialah capaian tersebut, bukan capaian EU), jika tidak eu_uk. extra.avgSpendUsd14d bagi halaman yang dicipta dalam tempoh 14 hari itu ialah perbelanjaannya sepanjang hari penuh sejak ia dicipta (sekurang-kurangnya satu hari; sebelum ini ia dikira daripada capaian 14 harinya merentasi 14 hari jika baris pengiklan mempunyainya).
• extra.history pada rekod pengiklan dan GET /v1/advertisers/{advertiserId}/history bermula pada hari halaman itu dicipta; extra.history.newAds tidak memuatkan nilai 0 pada hari yang terlepas oleh sumber data, extra.followersHistory serta suka dan pengikut pageAnalytics sesuatu iklan tidak memuatkan nilai 0 di antara dua bacaan melebihi 0 atau pada hari sedemikian, dan anggaran perbelanjaan harian mengekalkan dua tempat perpuluhan di bawah 10 USD.
• Halaman yang iklan aktifnya belum terdapat dalam sebarang senarai mempunyai meta.indexing pada rekodnya, dan halaman pertama GET /v1/advertisers/{advertiser_id}/ads yang kosong dengan meta.indexing dan meta.liveAds.
• Satu iklan (GET /v1/ads/{adId}): extra.spendHistory bermula pada hari iklan itu bermula, setiap spendUsd dengan dua tempat perpuluhan di bawah 10 USD; advertiser.totalReach tidak pernah lebih rendah daripada bacaan terakhir pageAnalytics.reachHistory (extra.pageRecordReach ketika itu memuatkan jumlah rekod, iaitu yang ditunjukkan senarai pengiklan); extra.recordSpend ialah perbelanjaan bagi extra.recordReach; extra.reachScope dan extra.pageReachScope menyatakan di mana kebanyakan capaian iklan itu dan halamannya dilihat.

Turut diubah pada 20 Oktober 2026 (penjejak jenama):

• Dalam GET /v1/brandtrackers dan GET /v1/brandtrackers/{id}, nilai 0 pada advertising.newAdsLastDay yang disertai pelancaran dalam 7 hari lepas disemak berdasarkan pelancaran kedai semalam: bilangannya, atau null (not_measured) jika tiada bacaan hari itu; satu senarai menyemak paling banyak 20 jenama bagi setiap panggilan, iaitu jenama pada halaman yang diminta.
• Dalam /top-ads dan /v1/workspace/top-ads, metrics.totalReach ialah capaian EU iklan itu: null bagi iklan yang dipaparkan di luar EU dan UK (eu_uk_only) atau iklan EU yang belum dikira (not_measured), bersama nullReasons, dan diletakkan paling akhir dalam isihan capaian (sebelum ini 0).
• /testing mengira statistik capaiannya daripada iklan yang capaiannya diketahui, dengan nullReasons stats.reach bagi kumpulan yang tiada satu pun.
• Dalam /hooks, /transcripts, /landing-pages serta hook dan halaman pendaratan ruang kerja, totalImpressions bernilai 0 ialah null dengan sebab baharu no_eu_reach (tiada capaian EU atau UK dikira untuk iklannya; not_measured dengan euOnly), diletakkan paling akhir dalam isihannya.
• Dalam /ad-rank, /scaling-ads dan /v1/workspace/scaling-ads, apabila sejarah kedudukan sesuatu iklan bermula di dalam tempoh 14 atau 30 hari, metrics.previousRank dan rankDelta dikira daripada bacaan paling lama di situ: metrics.since ialah hari itu dan meta.windowNote menyatakannya, dan angka yang tidak dapat diberikan ialah null dengan nullReasons.
• Dalam /partners, isOwnPage ialah true bagi halaman utama kedai, halaman rasminya yang dinamakan seperti jenama dan halaman yang dinamakan sebagai jenama itu (pencipta kandungan juga boleh dikira rasmi), dan capaian atau perbelanjaan null mempunyai nullReasons.
• Halaman pertama /ads dengan adCopyHashes mempunyai meta.latestAdDate dan dataFreshnessLagDays, dan dengan status=active mempunyai meta.stoppedCount.
• /demography ialah audiens di EU dan UK, dan negara yang kurang daripada satu per sepuluh ribu daripada negara teratas berpindah daripada countryDistribution ke otherCountries.
• /ad-copy-evolution dan /headline-evolution mempunyai satu titik bagi setiap hari yang direkodkan (0 apabila teks itu tidak digunakan, null pada hari yang dipotong pada teks yang disimpannya), menyusun teks mengikut hari terbaharu dan tidak memuatkan hari yang dibaca salah oleh sumber data (iklan aktif kurang daripada sepersepuluh hari di sekelilingnya, satu hari atau 2 atau 3 hari berturut-turut, atau teks yang jauh lebih sedikit daripada hari di kedua-dua belah), seperti yang dinyatakan oleh meta.periodNote; meta.recordedDays mengira hari-hari itu. Iklan aktif /time-series mingguan dan bulanan juga tidak memuatkan 2 atau 3 bacaan sedemikian berturut-turut.

Turut diubah pada 20 Oktober 2026 (laporan penjejak jenama, carian id dan capaian Google):

• Dalam /ad-rank, /scaling-ads dan /v1/workspace/scaling-ads, setiap kedudukan pada sesuatu baris datang daripada sejarah kedudukan iklan: metrics.currentRank ialah bacaannya pada hari kedudukan pustaka iklan dibaca (kedudukan yang ditunjukkan /top-ads; pustaka itu boleh ketinggalan sehari daripada sejarah), jika tidak bacaan terbaharunya, trajectory berakhir pada hari itu, dan jika tiada bacaan pada hari tempoh bermula, bacaan paling lama dalam tempoh itu yang dikira (perubahan sumber data sendiri sepanjang tempoh itu tidak lagi digunakan).
• 50 iklan pertama pustaka iklan (10 setiap jenama merentas jenama) disusun semula mengikut angka ini: iklan yang naik kurang daripada minRankDelta, atau berada di bawah maxCurrentRank, mengikut angka itu tidak dimuatkan (iklan yang sejarah kedudukannya tidak menunjukkan kenaikan, mengikut kiraan pustaka iklan sendiri), pagination meliputi iklan yang dikekalkan dan meta.rankNote menyatakan apa yang dibaca dan tidak dimuatkan, merentas jenama juga.
• /time-series harian (dan graph pada gambaran keseluruhan) ialah null pada hari yang iklan aktifnya dibaca salah oleh sumber data (kurang daripada sepersepuluh hari di kedua-dua belah; hari terbaharu kekal seperti yang dibaca, dalam evolusi teks juga), begitu juga pelancarannya, dan begitu juga pelancaran pada hari selepasnya apabila hampir semuanya ialah iklan aktif hari itu; minggu dan bulan tidak memuatkan pelancaran tersebut, dan leftOut menyenaraikan hari-hari itu. /landing-page-evolution tidak memuatkan hari-hari itu pada setiap halaman, dan bacaan sesuatu halaman sendiri yang kurang daripada sepersepuluh bacaan di kedua-dua belah, seperti yang dinyatakan oleh meta.periodNote halaman itu, bersama hari yang dicapai sejarah apabila ia ketinggalan.
• Kumpulan /testing tanpa capaian yang dikira mempunyai nullReasons stats.reach no_eu_reach kecuali jika salah satu iklannya belum dikira (not_measured) atau semuanya dipaparkan di luar EU dan UK (eu_uk_only); capaian dan perbelanjaan yang tiada pada baris /partners ialah not_measured hanya dalam 7 hari selepas launchDate baris itu, dan no_eu_reach selepas itu.
• /creatives menamakan iklan yang mempunyai beberapa imej atau video sebagai carousel (sebelum ini unknown).
• Dalam GET /v1/lookup, signals.monthlyVisits sesebuah kedai ialah null bagi laman web yang belum diukur (nullReasons not_measured; sebelum ini 0), iklan aktif pada baris kedai yang tepat (dengan setiap type, shop juga) ialah iklan halaman utamanya seperti yang dibaca oleh gambaran keseluruhan iklannya, iaitu mainPageActiveAds kedai itu, dan baris halaman milik kedai itu dibaca dengan cara yang sama; signals.monthlyVisits sesuatu jenama yang dijejak (dan totalTraffic jenama itu dalam GET /v1/brandtrackers) ialah null bagi laman web yang belum diukur dan menyatakan sebab ia tiada (not_measured, atau no_shop bagi halaman tanpa kedai), dan pada pelan Free, capaian halaman yang tiada dalam mana-mana pelan mengekalkan sebabnya (eu_uk_only, not_measured), dalam senarai pengiklan juga.
• reach.value yang null pada iklan Google mempunyai nullReasons (not_reported, eu_only), kecuali bagi capaian yang tidak termasuk dalam pelan itu.
• Dalam GET /v1/shops/{shopId}, advertising.mainPageActiveAds ialah iklan aktif halaman utama seperti yang dibaca oleh gambaran keseluruhan iklannya, iaitu kiraan yang ditunjukkan Halaman utama dalam linkedAdvertisers (sebelum ini ia kiraan indeks kedai, yang boleh lewat sehari).

Turut diubah pada 20 Oktober 2026 (TikTok dan e-mel):

• metrics.engagementRate pada baris TikTok ialah (suka + komen + perkongsian + simpanan) / tontonan sebagai pecahan (0.0513 ialah 5.13%; carian sebelum ini menghantar peratusan dan GET /v1/tiktok/library/{itemId} metrik lain), dan daysRunning ialah bilangan hari sejak siaran diterbitkan, dalam kedua-duanya.
• metrics.rank ialah kedudukan siaran itu dalam kalangan siaran penciptanya (1 ialah yang terbaik).
• profile.followers ialah null apabila sumber data belum mengiranya (sebelum ini ia menghantar 0), content.category ialah null bagi kategori menyeluruh All, dan content.hashtags ialah tag siaran itu, sekali sahaja setiap satu, dieja seperti dalam penerangannya dan tanpa tanda baca selepasnya (bagi rekod, ia senarai tag daripada sumber data, bagi baris carian, ia tag daripada penerangan).
• Rekod TikTok menambah profile.adsCount, organicCount dan avgPostsPerWeek90d, mengisi profile.pageCreation, dan mempunyai links null bagi baris sumber data yang tiada TikTok di sebaliknya (id kurang daripada 15 digit, atau diterbitkan sebelum 31 Ogos 2016, 22:00 UTC).
• sortBy=longestRunning bermula pada TikTok pertama (31 Ogos 2016, 22:00 UTC).
• Rekod e-mel menamakan jenis promosi, kategori dan acaranya, dan lawatan bulanan, iklan aktif, produk serta angka 90 hari kedainya ialah yang ditunjukkan senarai e-mel, begitu juga angka last90Days dalam statistik e-mel.
• Baris e-mel tidak memuatkan extra.shopActiveAds bagi nilai 0 tanpa jumlah iklan (nullReasons baris itu menyatakan not_measured), dan shop.marketing.activeAds pada rekod e-mel ketika itu ialah null; apabila angka kedai tidak dapat dibaca, rekod mempunyai meta.partial, amaran dan nullReasons failed bagi angka itu.
• Dalam alat MCP analyze_shop_emails, dominant menyusun jenis kempen, kategori, jenis promosi dan acara masing-masing secara berasingan dan tidak memuatkan No Promotion dan No Event.

Diubah pada 21 Oktober 2026:

• metrics.views pada item TikTok, serta likes dan saves yang bernilai 0 bersamanya, ialah null dengan nullReasons not_measured (begitu juga engagementRate) apabila sumber data menghantar 0 tontonan bersama suka, komen, perkongsian atau simpanan melebihi 0, dalam carian dan dalam GET /v1/tiktok/library/{itemId}; sortBy=views atau likes dengan order=asc menyenaraikan siaran yang tontonannya dikira (minViews 1).
• Carian iklan Meta dengan websiteIds menyenaraikan iklan milik kedai itu sendiri: setiap iklan halaman utama kedai dan halaman rasminya yang dinamakan sepertinya, serta iklan halaman lainnya (pencipta kandungan, penerbit dan rakan kongsi yang menjalankan iklannya) yang memaut ke kedai itu atau ke laman web pada domainnya; sehingga senarai dibaca hingga ke hujung, pagination.total carian itu ialah iklan halaman milik kedai yang dicari, iaitu anggaran (pagination.totalEstimated true), atau null apabila carian tidak menamakan sebarang halaman miliknya.
• Apabila sortBy=longestRunning digunakan, setiap kelompok iklan yang dibaca daripada sumber data disusun mengikut daysRunning.
• Dalam GET /v1/shops/{shopId}, advertising.activeAds mengira iklan aktif halaman milik kedai itu (linkedAdvertisers[].isOwnPage), dan dalam /products kedai itu, produk terlaris yang diberi kedudukan mempunyai tajuk, harga dan imej daripada catalog.bestSellers (harga produk terlaris boleh jadi harga terendah antara variannya).
• traffic.monthlyVisits sesebuah kedai (dan growth30d) ialah null dengan not_measured apabila ia bernilai 0 sejak sejarahnya jatuh kepada 0 sementara anggaran jualan melebihi 0 dan ada unit terjual, dalam rekod, kedai dalam senarai, kedai serupa dan carian id; domain sedemikian masih extra.storeWide.
• Dalam GET /v1/ads/{adId}, advertiser.totalReach ialah bacaan terakhir pageAnalytics.reachHistory selagi bacaan itu berumur paling lama 2 hari (extra.pageRecordReach ketika itu memuatkan jumlah rekod), extra.advertiserTotalAds diisi daripada angka senarai halaman itu (not_measured jika tiada), pertambahan capaian 7 hari dan 30 hari bagi iklan yang bermula dalam tempoh itu ialah seluruh capaiannya, dan pertambahan yang lebih rendah daripada tempoh yang lebih pendek ialah null (not_measured).
• statistics.ctaCount pada penjejak jenama menamakan setiap seruan tindakan seperti yang dilakukan content.callToAction ("Shop now").

Turut diubah pada 21 Oktober 2026 (kedai):

• Dalam GET /v1/shops/{shopId}, advertising.history ialah iklan aktif halaman utama mengikut hari pada setiap pelan (pada pelan Free ia mengira iklan setiap halaman), dan dokumentasi menyatakan bahawa capaian dan perbelanjaan advertising.summary, extra.adsLaunched30d, extra.totalAds dan extra.estimatedSpendUsd meliputi setiap halaman kedai, manakala advertising.activeAds mengira halaman miliknya sendiri.
• catalog.productsCount sesebuah kedai yang bernilai 0 tanpa sebarang produk disenaraikan, di samping lawatan, anggaran jualan atau unit terjual, ialah null dengan not_measured, dalam rekod, kedai dalam senarai dan meta.productsCount bagi GET /v1/shops/{shopId}/products; sortBy=productsCount tidak memuatkan kedai tersebut, dan dengan order=asc menghantar minProductsCount 1 kecuali minimum produk diberikan.
• Carian iklan Meta bagi sesebuah kedai yang disempitkan kepada halaman yang bukan miliknya (trackedPages) dan berakhir awal menyatakan sebabnya dalam meta.warnings, tanpa meminta supaya ia disempitkan lagi.
• GET /v1/filters/shops menyatakan dalam meta.warnings apabila sumber data tidak menyenaraikan sebarang nilai, dan menamakan senarai yang memberikannya.

Turut diubah pada 21 Oktober 2026 (penomboran, e-mel dan senarai iklan):

• Penomboran carian pengiklan tidak lagi gagal apabila sumber data tidak mahu menyambungnya (sebelum ini ia membalas 503, dan cuba semula tidak membantu): 100 hasil pertamanya dibaca dalam satu panggilan, dan halaman yang sampai ke penghujung apa yang boleh dibaca membalas hasMore false, dengan meta.partial true dan amaran yang menyatakan setakat mana carian itu dibaca.
• Halaman yang bermula melepasi total tepat sesuatu carian adalah kosong, dengan hasMore false.
• Carian TikTok yang diisih mengikut views atau likes dengan order=asc bermula pada TikTok pertama (31 Ogos 2016, 22:00 UTC), seperti longestRunning, dan metrics.views (dan engagementRate) pada item TikTok ialah null dengan not_measured apabila tontonannya kurang daripada suka.
• content.bodyPreview dan bodyLength pada e-mel, serta content.body pada rekod, ialah null dengan not_measured apabila sumber data menghantar teks ganti bagi isi e-mel yang belum dibacanya.
• Tarikh dan masa yang diberikan sumber data dalam UTC ditulis dengan satu cara dalam senarai dan rekod, dengan +00:00 dan tanpa sifar di hujung pada pecahan saat (2026-09-30T00:20:11.507+00:00; masa papan, kegemaran, penjejak jenama dan pautan kongsi anda sendiri dicipta atau diubah berakhir dengan Z, seperti sebelum ini), dan baris e-mel membawa id kategori, jenis promosi dan acara, seperti rekod e-mel.
• Setiap senarai berhalaman membalas pagination.hasMore, dan GET /v1/google-ads/facets/countries membalas objek pagination.
• Badan permintaan yang bukan JSON sah dibalas dengan 400 validation_failed bersama mesej "The request body is not valid JSON." dan details.position, aksara tempat ia terputus.
• Dalam senarai iklan Meta, capaian pada sesuatu baris ialah bacaan indeks iklan, yang boleh ketinggalan sehari daripada rekod iklan, dan pertambahan capaiannya null di samping capaian yang diketahui apabila sumber data tidak menyenaraikan sebarang pertambahan (not_measured), kecuali bagi tempoh iklan itu bermula, yang dalamnya ia memperoleh seluruh capaian yang dibaca barisnya; dalam GET /v1/ads/{adId}, pertambahan yang null di samping capaian yang diketahui juga mempunyai not_measured.

Diubah pada 22 Oktober 2026 (pelan Free):

• API dan pelayan MCP dipindahkan ke pelan berbayar: kunci akaun pada pelan Free membalas 403 plan_not_eligible pada setiap endpoint kecuali GET /v1/account, bersama details.upgradeUrl, dan tiada apa yang dikira. Tiada kunci boleh dibuat pada pelan Free.
• Pelan Free telah berubah sejak itu: Pelan Free menyatakan apa yang disertakannya kini.
• Kunci yang dibuat pada pelan berbayar dikekalkan, dan ia berfungsi semula sebaik sahaja akaun kembali ke pelan berbayar. Pautan kongsi yang dibuat oleh akaun pada pelan Free dijeda dengan cara yang sama.

Turut diubah pada 22 Oktober 2026 (laporan dan rekod kedai):

• Dalam GET /v1/shops/{shopId}/ad-ranking/series, rankDelta ialah kedudukan akhir tolak kedudukan awal (negatif apabila iklan naik, seperti pada setiap iklan; sebelum ini ia bilangan tempat yang diperoleh) dan improvementPercent kini improvementPct, iaitu pecahan; setiap baris /ad-ranking membawa dua angka yang sama bagi tempoh kedudukan itu dalam rank.
• Dalam /activity/calendar jenama yang dijejak, satu hari kalendar dan /activity/calendar/days, meta.partial ialah true atau false, meta.partialSources menamakan sumber yang dibaca sebahagian sahaja (pada /calendar dan satu hari), dan masa pratonton ialah UTC, termasuk siaran TikTok.
• Dalam GET /v1/shops/{shopId}/landing-pages/detail, activeAds menggunakan iklan halaman itu sebagai ganti, shareOfAds ialah linkedAdsTotal daripada shopActiveAds, snapshots mengira hari halaman itu ditangkap, lifetimeAds dan impressions telah dibuang (impresi itu ialah capaian yang sama), capaian 0 ialah null dengan nullReasons.reach no_eu_reach, dan linkedAds mempunyai medan baris carian iklan.
• /feed kedai menyenaraikan iklan Meta miliknya sendiri, seperti carian iklannya.
• GET /v1/market/q4-overview menerima sebarang from dan to dalam musim itu.
• Dalam /q4-season, winners menyenaraikan kunci setiap jualan bersama kreatifnya, dan url halaman pendaratan membawa skemanya.
• Pengesan Shopify membaca kedai pada domainnya tanpa www..
• GET /v1/advertisers/{advertiserId} serta halaman pendaratan, audiens dan campuran media jenama yang dijejak menggemakan hari lampau dalam meta.snapshotDate.
• Apabila statistik iklan Meta sesebuah kedai tidak dapat dibaca pada ketika itu, GET /v1/shops/{shopId} membalas meta.partial true dengan amaran: capaiannya, anggaran perbelanjaan yang dibuat daripadanya serta campuran media dan formatnya ialah null dengan nullReasons failed, iklannya mengikut negara dikira seperti yang diberikan barisnya dalam carian, dan jawapan itu tidak disimpan, jadi panggilan seterusnya membacanya semula (taklimat pesaing membawa meta.partial dan amaran yang sama).
• Halaman pendaratan pada domain milik kedai itu, atau subdomainnya, ialah toShop true dalam /v1/shops/{shopId}/advertisers dan /advertisers/{advertiserId}/landing-pages; apabila domain kedai tidak menyertakan domain itu, meta.domains menyenaraikannya dahulu daripada halaman pendaratan pada halamannya (fromLandingPages true, had bawah), dan shopAds sesuatu halaman tidak pernah kurang daripada iklan aktif halaman pendaratannya pada kedai itu (shopAdsAtLeast true apabila dinaikkan).
• Dalam GET /v1/tiktok/library/{itemId}, profile.latestPosts[].mediaUrl ialah video siaran itu, atau null dengan nullReasons not_reported (sebelum ini imej muka depan).
• Carian pengiklan membaca 100 hasil pertamanya dan menyatakan ia berakhir pada halaman yang sampai ke hasil ke-100 (hasMore false dan amaran itu), bukan pada halaman kosong selepasnya.
• Carian TikTok yang diisih mengikut views atau likes dengan order=asc kini tidak memuatkan siaran yang tontonannya tidak dikira (tontonan kurang daripada suka), dan pagination.total carian itu ialah anggaran (totalEstimated) sehingga senarai dibaca hingga ke hujung; setiap susunan lain menyenaraikannya, dengan tontonan null.

Turut diubah pada 22 Oktober 2026 (item tersimpan dan hook iklan):

• Baharu: GET /v1/boards/search mencari apa yang anda simpan, merentas setiap papan dan kegemaran anda, mengikut perkataan yang ditunjukkan setiap salinan tersimpan (setiap perkataan mesti muncul, dalam sebarang susunan; huruf besar dan kecil serta aksen diabaikan), id-nya atau nama papannya, dan menerima sourceType, boardId, savedFrom dan savedTo; ia hanya membaca item tersimpan anda, tidak pernah sumber data (MCP find_saved_items).
• Baharu: POST /v1/tools/ad-hooks menulis tiga ayat pembuka pendek untuk iklan produk anda, dan GET /v1/tools/ad-hooks memberikan kuota anda: tiada had bulanan pada pelan berbayar, dan had seminit (429 dengan Retry-After); membaca kuota tidak dikira (MCP write_ad_hooks).
• Pelayan MCP mempunyai 64 alat.

Turut diubah pada 23 Oktober 2026 (paparan tersimpan dan penapis kedai):

• Baharu: GET /v1/views menyenaraikan carian yang anda simpan pada halaman senarai di laman web, masing-masing dengan carian yang dihasilkannya (request: carian, searchType, sortBy, order dan penapis bernama, seperti yang diterima endpoint carian); POST /v1/views menyimpan satu, PATCH /v1/views/{viewId} menamakan semula, memindahkan atau mengubahnya dan DELETE /v1/views/{viewId} mengalih keluarnya. Ia hanya membaca dan menulis paparan anda sendiri, tidak pernah sumber data (MCP list_saved_views).
• Carian kedai menerima excludeCurrencies (kod mata wang seperti EUR), socialNetworks (instagram atau tiktok: kedai dengan mana-mana daripadanya) dan shopifyPlan (headless). trafficGrowth juga membaca 90 hari (min90, max90) dan adsGrowth 7 hari (min7, max7), atau period sesuatu peraturan (last90d, last7d); min dan max kekal 30 hari terakhir.
• Pelayan MCP mempunyai 65 alat.

Turut diubah pada 23 Oktober 2026 (pautan produk):

• Dalam GET /v1/shops/{shopId}, setiap item catalog.bestSellers membawa handle dan productUrl, iaitu halaman produk pada laman web milik kedai: alamat yang diberikan sumber data apabila ia berada pada domain kedai (atau subdomainnya) atau domain myshopify-nya, jika tidak https://<domain>/products/<handle> apabila handle-nya diketahui, jika tidak null.
• Dalam GET /v1/shops/{shopId}/products, productUrl mengikut peraturan yang sama, jadi alamat pada laman web lain tidak lagi diberikan, dan handle ialah null apabila ia bukan satu bahagian tunggal sesuatu alamat.

Turut diubah pada 23 Oktober 2026 (baris kedai, kedai serupa dan produk):

• createdAt sesebuah kedai (rekod kedai, baris kedai dan kedai serupa) hanyalah tarikh penciptaan kedai Shopify. Bagi laman web bukan Shopify, sumber data memberikan hari ia mula menjejak laman web itu, bukan tarikh penciptaannya: createdAt kini null (nullReasons tracking_date) dan hari itu ialah trackedSince yang baharu. Tarikh pada atau sebelum 1 Januari 2000 ialah nilai ganti sumber data dan ialah null (not_reported).
• catalog.bestSellers pada baris kedai membawa handle, productUrl (mengikut peraturan rekod kedai) dan rank (1 ialah produk terlaris), dan baris membawa profile.isHeadless dan catalog.myShopifyDomain, seperti rekod kedai.
• googleAds.reach.value pada baris kedai ialah null: baris kedai tidak membawa capaian Google, yang terdapat pada rekod kedai (extra.googleAds.reach).
• Kedai serupa (GET /v1/shops/{shopId}/similar, similarShops pada rekod) mengekalkan extra mereka (logo, Trustpilot, sejarah jualan). Senarai kedai serupa yang dihentikan sumber data sebelum penghujungnya membalas meta.partial dan amaran pada halaman yang sampai ke titik itu.
• Dalam GET /v1/shops/{shopId}/products, createdAt dan publishedAt ialah jam kedai itu sendiri yang dihantar sebagai UTC (awal 8 jam bagi kedai pada waktu Pasifik AS). Kini ia UTC, dengan updatedAt yang baharu, berdasarkan ofset kedai daripada UTC (meta.shopUtcOffset, seperti -08:00). Apabila tiada ofset dapat dibaca, ketiga-tiganya null (local_time) dan createdAtLocal, publishedAtLocal dan updatedAtLocal memberikan jam kedai, tanpa zon.
• Produk yang disenaraikan hanya dalam produk terlaris pada butiran kedai mempunyai publishedAt dan updatedAt null (not_reported): nilai sumber data ialah salinan masa penciptaannya.
• Setiap produk menyatakan senarai yang memuatkannya (lists: bestSellers, newest) dan tempatnya antara yang terlaris (listPosition, 1 hingga 100).

Turut diubah pada 23 Oktober 2026 (rekod kedai):

• Dalam GET /v1/shops/{shopId}, extra.googleAds.reach.value sentiasa null: kini ia ialah capaian EU Google kedai itu, dengan lowerBound dan upperBound, dan extra.googleAds menambah reachHistory, history (iklan Google kedai itu yang ditandakan aktif mengikut minggu), updatedAt dan latestAds.
• growth30d sesuatu rangkaian sosial kini ialah perubahan 30 hari pada gambaran keseluruhan pengikut (sebelum ini tempoh lain bagi sesetengah halaman Facebook: 0.3636 sedangkan perubahannya 0.2898). GET /v1/shops/{shopId}/socials memberikannya sebagai growth30d juga.
• Profil X kedai ialah socials.x. socials.twitter dinamakan semula kepada socials.x dan kekal, objek yang sama, selama satu keluaran. Setiap rangkaian mempunyai url, dan socials.others menyenaraikan pautan lain kedai itu.
• tiktok.profileMetrics.percentAds ialah peratusan (0 hingga 100); adsShare yang baharu ialah nilai yang sama sebagai pecahan. tiktok menambah avatarUrl, history, postsChange30d, postsChange30dPct dan latestAds, dan tiktok.activity.avgActiveAds7d serta avgActiveAds30d, yang sebelum ini null, memberikan purata iklan TikTok kedai itu mengikut hari.
• Baharu pada pelan berbayar: advertising.summary.firstAdSeenAt, longestRunningDays, medianRunningDays, landingPagesCount dan perubahan 30 hari bagi iklan aktif, iklan yang dilancarkan dan capaian EU (activeAdsChange30d, launchedChange30d, reachChange30d, masing-masing juga sebagai pecahan, …Pct), dan advertising.runningDaysMix, reachCountries, reachHistory, topLandingPages, adsByAgeRange dan adsByGender. Pada setiap pelan: advertising.allPagesHistory dan advertising.topCountries[].ads.
• Baharu: catalog.bestSellers[].rank, sales.hasSubscription, technology.apps[].appStoreUrl dan categories, profile.isHeadless, extra.updatedAt, serta createdAt dan trackedSince bagi tarikh kedai di atas.
• GET /v1/shops/{shopId}/advertisers menambah logoUrl dan moreLandingPages bagi setiap halaman, profileUrl jika gambaran keseluruhan iklan tiada, serta landingPagesCount dan moreLandingPages bagi setiap domain.

Turut diubah pada 23 Oktober 2026 (produk):

• Baharu: GET /v1/products dan POST /v1/products/query mencari dan melayari produk kedai, masing-masing dengan harga, anggaran jualan, unit terjual, ulasan, kedudukan produk terlaris, iklan Meta, capaian dan perbelanjaan EU, negara jualan, tarikh pelancaran dan kedai, diisih mengikut relevance, newest (tarikh pelancaran), activeAds atau spend (perbelanjaan iklan EU dalam 30 hari lepas) (MCP search_products). searchType memadankan teks dengan nama produk atau domain kedainya, dan penapis bernama menghadkan harga dalam USD, iklan aktif, bahagian iklan, bilangan ulasan dan hari pelancaran, serta menerima mata wang dan langganan; GET /v1/filters/products menyenaraikan mata wang yang diterimanya.
• shop (domain atau id satu kedai) hanya menyenaraikan produk kedai itu, tanpa teks carian di sebelahnya, pada carian produk dan dalam search_products. Papan menyimpan produk (sourceType product) seperti yang ditunjukkan carian kali terakhir, dan carian semua yang disimpan menemuinya melalui tajuk dan kedainya.
• Pelayan MCP mempunyai 73 alat.

Turut diubah pada 23 Oktober 2026 (penapis produk):

• Carian produk menerima lebih banyak penapis bernama: anggaran jualan sebulan atau sehari (minEstMonthlySales, minEstDailySales dan nilai maksimumnya; had sehari ialah 30 hari daripada nilai itu), unit terjual sebulan atau sehari (minUnitsSoldMonthly, minUnitsSoldDaily), sellingCountries (produk yang dijual ke mana-mana daripadanya), shopCountries, skor ulasan (minRating, maxRating), minAdsLaunched (iklan Meta yang dilancarkan dalam 30 hari lepas), minSpendShare, minEuReach (capaian EU dalam 30 hari), hasPartnershipAds, promoTypes (percent-off) dan minShopProductsCount, masing-masing dengan nilai maksimumnya jika ada; GET /v1/filters/products turut menyenaraikan negara kedai.
• sortBy menerima estSales (anggaran jualan), adPressure (bahagian iklan) dan bestSelling (kedudukan produk terlaris dalam kedainya, kedudukan 1 dahulu), dan searchType menerima productDescription dan url.
• Setiap produk mempunyai iklan terkininya (advertising.latestAds, dengan gambarnya dalam advertising.previewUrls) dan minggunya (weeks: iklan aktif, bahagian iklan, perbelanjaan dan capaian EU sehari), dan bestSeller.rankPercent ialah kedudukannya sebagai peratusan produk kedai (lebih rendah lebih baik).

Diubah pada 24 Oktober 2026 (parameter, bacaan yang gagal dan halaman yang jauh):

• Parameter pertanyaan yang tidak dibaca oleh sesuatu endpoint ditolak dengan 400 validation_failed, yang mesejnya menamakannya dan menyenaraikan parameter yang diterima endpoint itu, sedangkan sebelum ini ia diabaikan tanpa sebarang makluman (nama yang tersalah eja, atau penapis yang dihantar ke endpoint yang tiada penapis itu, dijawab seolah-olah tidak pernah dihantar). Carian menolak penapis bernama yang tidak dikenali seperti sebelum ini. Parameter biasa (country, mediaType, active, type) yang menetapkan penapis yang turut ditetapkan oleh penapis bernama, kepada nilai lain, juga ditolak.
• Penjejak jenama: /ads dan /timeline/metadata menolak snapshotDate yang lalu (kedua-duanya membaca pustaka iklan seperti sekarang), /partnership-ads menolak sortBy yang tidak dikenali, /v1/workspace/scaling-ads menolak period yang tidak dikenali, dan senarai penjejak menolak hasNewAdsSince lebih daripada 30 hari ke belakang (pembilang iklan baharu meliputi 30 hari). /v1/workspace/hooks, /ad-copies dan /landing-pages membaca baris setiap jenama dalam sortBy dan order yang diminta sebelum menggabungkannya. Laporan merentas jenama di laman web menghantar euOnly hanya kepada laporan yang membacanya.
• Kedai serupa menolak displayInTrending dalam filters (senarai itu tiada bendera indeks kedai) dan membaca had pertumbuhannya sebagai peratusan, seperti carian kedai; offset melebihi apa yang boleh dibaca satu permintaan (600 kedai selepas yang sudah dibaca) ditolak dengan 400 yang menyatakan sejauh mana ia boleh pergi, dan halaman tempat bacaan terhenti mempunyai meta.partial dengan amaran. Pustaka TikTok sesebuah kedai menolak penapis profil dan laman web (skop kedai itu sendiri menggantikannya).
• Bahagian jawapan yang tidak dapat dibaca sumber data kali ini menetapkan meta.partial dengan amaran (dan jawapan itu tidak disimpan dalam cache), bukan ruang kosong yang tidak dimaklumkan atau senarai kosong; jawapan sumber data yang bukan JSON ialah 503 upstream_error, dan kedai tersimpan, penjejak baharu atau senarai pilihan e-mel yang bacaannya gagal membalas ralat itu, bukan not_found. Halaman yang lebih dalam daripada satu bacaan senarai yang tidak memuatkan sesetengah baris mempunyai meta.partial dan hasMore true, dan teks iklan, rakan kongsi dan ujian kreatif sesuatu jenama menyatakannya dengan meta.partial apabila satu bacaan tidak meliputi jenama itu.
• GET /v1/google-ads/facets/networks menerima search, limit dan offset, seperti senarai pilihan yang lain. metric bagi /v1/shops/compare adalah wajib (rujukan menyatakan ia tidak wajib).
• MCP: alat menolak argumen yang tidak dibaca oleh jenis yang dipilihnya (shop_report, lookup_filter_ids, market_overview, scan_advertiser) dan argumen yang bercanggah (trend_signal dengan sort_by, active_only dengan status, argumen bernama dengan filters); creative_inspiration_pack menyusun iklan semua kata kunci bersama-sama.

Turut diubah pada 24 Oktober 2026 (cari mengikut imej):

• Baharu: POST /v1/products/image-search mencari produk kedai yang menyerupai sesuatu gambar, masing-masing dengan kedainya, yang paling hampir dahulu. Hantar gambar sebagai multipart/form-data: fail PNG, JPG atau WEBP yang tidak melebihi 10 MB (image), atau URL imej terus (imageUrl), yang kami muat turun sendiri. Setiap baris ialah baris produk seperti yang dibalas carian produk, dengan similarity (0.7 hingga 1) dan matchOnly (padanan yang tiada rekodnya dalam indeks produk: hanya tajuk, gambar, harga, tarikh pelancaran dan kedainya).
• Carian ini menerima penapis bernama carian produk, sortBy (relevance, estSales, activeAds, adPressure, newest, spend, spend14d) dan maxPerShop (1, 3, 5, 10 atau 20 padanan terdekat bagi setiap kedai), dalam halaman sehingga 32. GET /v1/products/image-search/{searchId} membaca halaman lain, isihan, penapis dan hasil setiap kedai tanpa menghantar gambar sekali lagi, dan GET /v1/products/image-search/history menyenaraikan carian imej terbaharu anda sendiri.
• Gambar ditulis semula sebelum dicari, sebagai JPEG tanpa metadatanya (EXIF, lokasi, komen), dan URL imej tidak pernah keluar daripada pelayan kami. Ralat baharu: 400 invalid_image, 400 unsupported_url dan 422 unreadable_image.
• Pada pelan Free, carian imej disusun mengikut perkaitan, tanpa penapis. Pelayan MCP mempunyai 67 alat: search_products_by_image ialah yang baharu.

Diubah pada 25 Oktober 2026 (kredit):

• API dan pelayan MCP diukur dalam kredit dan bukan permintaan: 1 kredit = 1 hasil yang dikembalikan: butiran satu jenama, satu iklan, atau satu baris senarai. Hasil kosong adalah percuma. Satu panggilan berharga seberapa banyak hasil yang dipulangkannya, dan peruntukan bulanan pelan ialah dalam kredit.
• Jawapan yang diukur menghantar X-Usage-Cost, X-Credits-Used, X-Credits-Remaining dan X-Credits-Source; GET /v1/usage melaporkan kredit tambah nilai di bawah credits.topup.balance.
• 402 insufficient_credits muncul apabila kredit bulan itu dan kredit tambah nilai kedua-duanya telah habis digunakan, dengan details.upgradeUrl dan details.topUpUrl.
• Had kadar dikongsi oleh seluruh ruang kerja.

Pautan kongsi (shareUrl) membuka halaman web pada https://sellwinners.com yang boleh dilihat oleh sesiapa sahaja. Rekod yang sama tersedia sebagai JSON daripada /v1/shared/ads/{token} dan /v1/shared/boards/{token}. Pautan yang pemiliknya berada pada pelan Free membalas 403 forbidden sehingga pemilik kembali ke pelan berbayar.

Endpoint identiti /v1/me, /v1/usage dan /v1/workspace mengembalikan objeknya pada peringkat teratas, di sebelah requestId. Endpoint sistem /v1, /v1/health dan /v1/system/freshness tidak membawa requestId, dan /v1 serta /v1/health membalas objek biasa tanpa data. ID permintaan juga dihantar dalam pengepala X-Request-Id. Nyatakannya apabila anda menghubungi sokongan.

Papan, kegemaran dan penjejak jenama juga mempunyai endpoint POST, PATCH dan DELETE. Ia menerima badan JSON, yang dihantar dengan Content-Type: application/json.

Penomboran halaman

Endpoint senarai menerima limit (sehingga 100 pada carian; senarai facet menerima sehingga 500 dan /snapshots sesuatu jenama sehingga 365) dan sama ada page (1, 2, 3…) atau offset. Apabila kedua-duanya dihantar, offset yang digunakan. Saiz halaman lalai disenaraikan bersama setiap endpoint. Senarai iklan, iklan Google, TikTok, e-mel dan media membalas dengan:

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

Senarai kedai, produk dan pengiklan, serta iklan satu pengiklan, membalas dengan:

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

Untuk mendapatkan halaman seterusnya, ulang permintaan yang sama dengan page tambah satu, atau dengan offset tambah limit. Dalam badan POST …/query, hantar "page" atau "offset" sebagai medan. hasMore ialah false pada halaman terakhir. Apabila sumber data tidak mahu menyambung carian melepasi sesuatu titik, halaman yang sampai ke titik itu membalas hasMore false dengan meta.partial true dan amaran yang menyatakan berapa banyak hasil boleh dibaca. Penomboran sampai ke 5,000 hasil pertama sesuatu carian (carian pengiklan, 100 yang pertama). Sempitkan carian dengan penapis atau tukar isihan untuk melihat hasil lain.

Senarai iklan Google mengembalikan total yang tepat, kecuali senarai yang disempitkan oleh peraturan status atau hari berjalan (lihat carian iklan Google). "totalEstimated": true menandakan total (dan totalPages miliknya) yang merupakan anggaran sehingga senarai dibaca hingga ke hujung, seperti pada kedai serupa sesebuah kedai dan carian iklan Meta bagi sesebuah kedai (websiteIds).

Papan, kegemaran dan laporan penjejak jenama menerima page dan limit serta membalas dengan page, limit, total, totalPages dan hasMore. Senarai facet, /products sesebuah kedai dan kedai serupa /similar bagi kedai itu menerima limit dan offset serta membalas dengan limit, offset, total dan hasMore.

Isihan & penapis

Endpoint carian menerima sortBy dan order (desc secara lalai). Apabila anda menghantar istilah carian, hasil diisih mengikut relevance melainkan anda memilih isihan lain; tanpa istilah carian, lalainya ialah newest (kedai dan produk: relevance, media: reach). Carian iklan Google dan TikTok sentiasa disusun mengikut perkaitan; di situ, sortBy terpakai apabila anda melayari tanpa istilah carian.

Setiap jenis data mempunyai endpoint POST …/query yang menerima badan JSON dengan query, filters, sortBy, order, limit dan page (atau offset) untuk penapisan lanjutan. Gunakan endpoint facet untuk melihat nilai dan id yang diterima penapis.

Penapis boleh dihantar mengikut nama: sebagai parameter pertanyaan tambahan pada carian GET (?status=active&minDaysRunning=30&mainCountries=US,GB) atau sebagai medan peringkat teratas badan POST …/query ({"status": "active", "minDaysRunning": 30}). Setiap endpoint di bawah menyenaraikan nama yang diterimanya. Pada endpoint carian, nama penapis yang tidak disokong oleh endpoint itu mengembalikan 400 validation_failed yang menyenaraikan nama yang disokong, jadi salah taip tidak akan mengembalikan hasil tanpa penapis secara senyap; laporan penjejak jenama mengabaikan nama yang tidak dikenali. Senarai menerima nilai yang dipisahkan koma atau tatasusunan JSON, tarikh menggunakan 2026-01-31, dan objek filters mentah masih berfungsi bersama penapis bernama.

Penapis pertumbuhan (trafficGrowth, adsGrowth, pageReachGrowth, adReachGrowth) menerima peraturan yang ditulis sebagai {"comparison": "greater" | "lower", "value": 50} atau {"operator": "gte" | "lte", "value": 50}. Nilai ialah peratusan dalam 30 hari terakhir; tempoh lain tidak tersedia. minRankDelta ialah bilangan kedudukan minimum yang dinaiki sesuatu iklan sepanjang rankDeltaWindow (7d melainkan anda menghantar 14d atau 30d). hideSavedAds tidak memuatkan iklan yang telah anda simpan. Id kategori bagi setiap penapis categoryIds datang daripada /v1/facets/categories.

Had kadar & kredit

1 kredit = 1 hasil yang dikembalikan: butiran satu jenama, satu iklan, atau satu baris senarai. Hasil kosong adalah percuma. Setiap pelan menyertakan kredit untuk sebulan, diperbaharui pada 00:00 UTC pada hari pertama bulan. Satu panggilan berharga seberapa banyak hasil yang dipulangkannya, jadi limit yang lebih kecil lebih murah, dan panggilan alat MCP juga berharga seberapa banyak hasil yang dipulangkannya, seperti API. Kredit dan had kadar adalah bagi setiap ruang kerja: semua orang di dalamnya, semua kuncinya, API dan pelayan MCP berkongsi satu kumpulan kredit dan satu had kadar. Pada pelan berbayar, pemilik ruang kerja boleh membeli kredit tambah nilai pada halaman pengebilan (€1 membeli 120, bermula daripada €10): ia digunakan selepas kredit bulan itu, dibawa ke hadapan dan tidak pernah tamat tempoh.

Setiap jawapan yang diukur menyertakan:

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

Apabila melebihi had kadar seminit, anda mendapat 429 rate_limited dengan pengepala Retry-After (dalam saat). Apabila kredit bulan itu dan kredit tambah nilai kedua-duanya telah habis digunakan, anda mendapat 402 insufficient_credits, dengan details.upgradeUrl dan details.topUpUrl, sehingga kredit bulanan diperbaharui. Semak kredit anda pada bila-bila masa dengan GET /v1/account atau GET /v1/usage. Panggilan ini tidak mengenakan sebarang kos, tetap menghantar X-Usage-Cost: 0, X-Credits-Used: 0 dan X-Credits-Remaining, dan berfungsi walaupun kredit telah habis.

Had ini terpakai untuk API dan pelayan MCP, pada pelan berbayar dan pada pelan Free. Apl web di laman web tidak diukur: ia tanpa had pada pelan berbayar, dalam lingkungan penggunaan saksama.

Pelan Free

Pelan Free menyertakan apl web dan pelayan MCP (150 kredit sebulan), tanpa API. Akaun Free boleh membuat kunci untuk pelayan MCP (ejen AI) dalam papan pemukanya, dalam lingkungan 150 kredit sebulan dan 10 permintaan seminit; REST API terdapat pada pelan berbayar: dengan kunci Free, ia membalas 403 plan_not_eligible, dengan details.feature, details.requiredPlan dan details.upgradeUrl, pada setiap endpoint kecuali GET /v1/account, dan tiada apa yang dikira. Kunci yang dibuat pada pelan berbayar dijeda pada pelan Free, dan ia berfungsi semula sebaik sahaja akaun kembali ke pelan berbayar. Pada pelan Free, carian membalas hasil pertamanya dan alat atau endpoint yang datanya tidak termasuk dalam Free membalas dengan mesej pelan berbayar. Perbandingan pelan menunjukkan apa yang termasuk dalam Free. Jenama demo terbuka sepenuhnya di laman web.

Ralat

Ralat menggunakan kod status HTTP standard dan badan JSON:

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

code stabil dan selamat untuk dijadikan asas logik anda, message ditulis untuk manusia, dan details membawa data tambahan apabila ada (medan yang ditolak bagi 400; kredit bulanan, tarikh pembaharuannya, upgradeUrl dan topUpUrl bagi 402).

URL media

Imej dan video dalam respons disajikan daripada CDN kami di https://api.sellwinners.com/v1/media/file/…. URL ini tidak memerlukan kunci API dan tidak menggunakan kredit, jadi anda boleh menyematkannya terus dalam teg <img> dan <video>. Fail yang sudah tiada pada sumber data dihantar sebagai null selama sehari, dan fail yang tiada membalas 404 kosong dengan jenis medianya. Imej produk dan ikon apl yang dihoskan pada CDN Shopify turut disajikan daripada CDN kami. Untuk memaparkan imej dalam saiz kecil, tambah ?w=96 (imej kecil) atau ?w=480 (kad): imej JPEG, PNG, WebP atau GIF kemudian dihantar sebagai WebP pada lebar itu paling besar, tidak pernah dibesarkan; animasi, imej yang lebih kecil atau video dihantar seperti sedia ada. Untuk senarai kreatif yang rata dan sedia dipaparkan, gunakan /v1/media.

Untuk memaparkan imej pada saiznya sendiri tetapi lebih ringan, tambah ?w=full: imej JPEG, PNG, WebP atau GIF kemudian dihantar sebagai WebP pada lebar dan tinggi asalnya, dengan kualiti yang kelihatan sama, apabila itu menjimatkan sekurang-kurangnya satu persepuluh daripada fail; jika tidak, dan bagi animasi atau video, fail asal dihantar seperti sedia ada. Tanpa w, fail asal dihantar.

Penemuan

Tukar nama, domain atau id halaman kepada id yang diterima oleh endpoint lain.

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"

Kedai

Cari kedai Shopify dan dapatkan produk, trafik, jualan, akaun sosial dan iklan.

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"

Pasaran

Jumlah harian seluruh pasaran, serta musim Q4.

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"

Iklan Meta

Kreatif iklan Facebook dan Instagram dengan media, capaian dan kedudukan.

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

Kreatif iklan 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

Iklan dan siaran organik TikTok.

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

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

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

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

Media

Kreatif sedia dipaparkan: URL imej dan video pada CDN kami.

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"

Pengiklan

Pengiklan (halaman Facebook) dan aktiviti mereka.

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

E-mel pemasaran dan surat berita jenama.

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"

Produk

Produk kedai bersama harga, jualan, ulasan, iklan dan capaian EU.

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"

Faset

Nilai dan id yang diterima oleh penapis carian.

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"

Papan

Simpan iklan, kedai, produk, e-mel dan pengiklan pada papan, dan kongsikannya.

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"

Kegemaran

Iklan, kedai dan e-mel kegemaran, dalam folder.

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

Paparan tersimpan

Carian yang anda simpan pada halaman senarai laman web, mengikut halaman.

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"

Penjejak jenama

Jejaki jenama dan baca laporan tentang iklan, kreatif dan halaman pendaratan mereka.

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