API pustaka iklan untuk iklan Meta, Google dan TikTok

Setiap carian menggunakan kunci yang sama, penomboran halaman yang sama dan kod ralat yang sama, dan menjawab dalam JSON. Panggil daripada skrip atau apl anda sendiri, atau biarkan ejen AI memanggilnya melalui pelayan MCP.

Iklan Meta, iklan Google dan TikTok dalam satu API pustaka iklan

Tiga set data iklan berada di sebalik kunci itu. Iklan Meta meliputi Facebook dan Instagram, dan anda mencarinya mengikut perkataan dalam teks, jenama atau halaman pendaratan. Iklan Google hadir sebagai iklan teks, imej dan video, dengan penapis untuk rangkaian tempat ia dijalankan, termasuk YouTube. Iklan video memaut ke Ads Transparency Center milik Google, tempat ia dimainkan. TikTok memberikan iklan dan siaran organik dalam satu carian, dengan tontonan, suka dan perkongsiannya.

Setiap iklan menunjuk kepada jenama di sebaliknya: halaman pengiklan dan, apabila ada, kedai Shopify yang dipautkan kepadanya. Jadi anda boleh beralih daripada iklan ke kedai, kemudian ke trafik dan produk terlaris kedai itu, dengan kunci yang sama.

Senarai penuh terdapat dalam dokumentasi API. Jika anda lebih suka mengklik daripada menulis kod, carian yang sama berjalan dalam alat risikan iklan kami.

Dapatkan kunci API dan hantar permintaan pertama anda

1. Cipta akaun, sahkan e-mel anda dan pilih pelan berbayar: API bermula di situ.
2. Buka Kunci API dalam papan pemuka anda dan cipta kunci. Salinnya segera: ia hanya dipaparkan sekali.
3. Hantar kunci pada setiap permintaan, dalam pengepala X-API-Key atau sebagai token bearer.

Permintaan ini mencari iklan video penjagaan kulit yang masih berjalan. Ia berfungsi pada setiap pelan berbayar:

# Search Meta ads
curl "https://api.sellwinners.com/v1/ads?search=skincare&status=active&mediaType=video&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/ads Parameter dan medan dalam dokumentasi

Jawapan itu memuatkan requestId, iklan di bawah data dan objek pagination. Dalam setiap iklan, media mempunyai URL gambar kecil dan video, content tajuk, teks, seruan tindakan dan halaman pendaratan, dan advertiser halaman yang menjalankannya. metrics mengira pendua, dan menambah capaian dan anggaran perbelanjaan.

Carian Meta memulangkan satu iklan bagi setiap jenama, jadi satu pengiklan tidak boleh memenuhi halaman. Naikkan maxAdsPerBrand (sehingga 15, atau 0 untuk tiada had) untuk melihat lebih banyak bagi setiap satu.

Tapis mengikut nama

Iklan Meta menerima 111 penapis bernama, dihantar sebagai parameter pertanyaan pada GET atau sebagai medan badan pada POST. Yang biasa ialah minDaysRunning, countries, cta dan minDuplicates. Nama yang salah eja mendapat 400 validation_failed yang menyenaraikan nama yang diterima oleh endpoint, jadi kesalahan menaip tidak akan memulangkan iklan yang tidak ditapis.

# Search Meta ads with advanced filters
curl -X POST "https://api.sellwinners.com/v1/ads/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "skincare", "status": "active", "mediaType": "video", "countries": ["US"], "minDaysRunning": 30, "sortBy": "reach", "limit": 10}'

POST /v1/ads/query Parameter dan medan dalam dokumentasi

Capaian bermaksud capaian di EU dan UK, dan perbelanjaan sentiasa anggaran.

Semua iklan satu jenama

Cari id pengiklan jenama itu dengan GET /v1/lookup?q=allbirds.com&type=advertiser, kemudian senaraikan iklannya, yang paling lama berjalan dahulu:

# Meta ads of one advertiser
curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/ads?sortBy=longestRunning&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/advertisers/{advertiser_id}/ads Parameter dan medan dalam dokumentasi

Halaman carian pustaka iklan Meta kami membincangkan paparan ini dalam apl web, bersama campuran format dan halaman pendaratan jenama itu.

Semak hasil halaman demi halaman

Carian menerima limit (sehingga 100) dan sama ada page atau offset. Untuk halaman seterusnya, ulang permintaan dengan page tambah satu, atau offset tambah limit. Berhenti apabila hasMore ialah false.

Penomboran halaman mencapai 5,000 hasil pertama bagi sesuatu carian (bagi carian pengiklan, 100 yang pertama). Untuk pergi lebih jauh, tambah penapis atau tukar isihan. Kebanyakan penyelidikan memerlukan bahagian atas senarai yang ditapis dengan baik, bukan halaman 200.

Had kadar dan kredit mengikut pelan

1 kredit = 1 hasil yang dikembalikan: butiran satu jenama, satu iklan, atau satu baris senarai. Hasil kosong adalah percuma. Ralat, penolakan, carian id dan nilai penapis tidak dikenakan sebarang kredit, dan panggilan alat MCP dikenakan kredit mengikut hasil yang dipulangkannya, sama seperti API. Semua orang dalam ruang kerja, kunci mereka, API dan pelayan MCP berkongsi satu kumpulan kredit dan satu had kadar. Kredit bulanan diperbaharui pada 00:00 UTC pada hari pertama setiap bulan; kredit tambah nilai yang dibeli di halaman pengebilan dibawa ke hadapan.

Setiap jawapan membawa X-RateLimit-Remaining dan X-Credits-Remaining, dan X-Usage-Cost menyatakan kos panggilan itu, supaya kod anda dapat memperlahankan sebelum ditolak. Melebihi had seminit, anda mendapat 429 rate_limited dengan Retry-After dalam saat. Apabila kredit bulanan dan sebarang kredit tambah nilai habis digunakan, anda mendapat 402 insufficient_credits sehingga kredit diperbaharui. GET /v1/usage menunjukkan kedudukan anda dan tidak dikenakan kredit. Lagi dalam had kadar dan kredit.

Cari iklan daripada ejen AI dengan pelayan MCP

Pelayan MCP memberikan ejen AI data yang sama sebagai alat, melalui streamable HTTP, dengan kunci API anda dalam pengepala X-API-Key. Halaman Pelayan MCP untuk ejen AI kami mempunyai URL pelayan dan konfigurasi sedia untuk Cursor, VS Code dan Claude Desktop.

Untuk penyelidikan iklan, ejen kebanyakannya memanggil search_ads, scan_ad untuk membuka satu iklan, search_google_ads_library, search_tiktok_library dan search_advertisers. Anda bertanya dalam bahasa biasa: "Cari iklan video penjagaan kulit yang masih berjalan di AS, buka tiga yang paling lama berjalan dan senaraikan hook mereka." Ejen mengubahnya menjadi penapis dan panggilan. Peraturan pelan sama seperti pada API.

Bezanya dengan API Ad Library Meta

SellWinners bukan API rasmi Meta. Ia ialah perkhidmatan bebas dan tidak bersekutu dengan Meta. Meta menjalankan API Ad Library miliknya sendiri. Pada halaman alat Ad Library milik Meta ("Meta Ad Library tools" dalam Transparency Center), Meta menyatakan bahawa API itu "allows for a deeper analysis of ads about social issues, elections or politics, as well as ads that deliver to the EU and associated territories", dan menyebut "authorized users". Kami menyemak halaman itu pada 19 Oktober 2026.

Kedua-duanya melayani kerja yang berbeza. API Meta dikendalikan oleh Meta, di bawah peraturan Meta. SellWinners dibina untuk penyelidikan e-dagang:

• Satu kunci untuk iklan Meta, Google dan TikTok, dengan penomboran halaman, ralat dan had yang sama.
• Iklan dikaitkan dengan jenama di sebaliknya: halaman pengiklan, dan kedai Shopify apabila ada.
• Penapis yang membantu anda mengesan iklan yang terus berjalan: hari berjalan, pendua, seruan tindakan dan kedudukan iklan.
• Pelayan MCP, supaya ejen AI boleh menjalankan carian untuk anda.
• Capaian bagi iklan yang dipaparkan di EU dan UK, dan anggaran perbelanjaan.

Jika kerja anda berkaitan iklan politik atau iklan isu, API Meta sendiri dibina untuk itu. Jika anda mahu melihat apa yang dijalankan jenama e-dagang pada tiga rangkaian, dan kedai mana yang berada di sebalik iklan itu, itulah kerja yang dilakukan oleh SellWinners.

Seterusnya ke mana

Mulakan dengan satu soalan, seperti jenama penjagaan kulit mana yang mengekalkan video yang sama selama sebulan. Jalankan sekali dengan curl, kemudian pindahkan ke dalam kod anda. Untuk mendalami satu platform, buka pustaka iklan TikTok, pustaka iklan Google atau carian pengiklan. Untuk mengikuti seorang pesaing, menjejak iklan sesuatu jenama dari semasa ke semasa. Untuk pasaran yang lebih luas, lihat perbandingan alat risikan iklan.

Cari iklan dalam Teroka