Een advertentiebibliotheek-API voor Meta-, Google- en TikTok-advertenties

Elke zoekopdracht gebruikt dezelfde sleutel, dezelfde paginering en dezelfde foutcodes, en antwoordt in JSON. Roep de API aan vanuit een script of je eigen app, of laat een AI-agent hem aanroepen via de MCP-server.

Meta-advertenties, Google-advertenties en TikTok in één API voor advertentiebibliotheken

Achter de sleutel zitten drie advertentiedatasets. Meta-advertenties dekken Facebook en Instagram, en je doorzoekt ze op woorden in de tekst, het merk of de landingspagina. Google-advertenties komen als tekst-, afbeeldings- en videoadvertenties, met een filter voor het netwerk waarop ze liepen, inclusief YouTube. Een videoadvertentie linkt naar het Ads Transparency Center van Google, waar hij wordt afgespeeld. TikTok geeft je advertenties en organische posts in één zoekopdracht, met hun weergaven, likes en shares.

Elke advertentie verwijst naar het merk erachter: de adverteerderspagina en, als die er is, de Shopify-winkel die eraan is gekoppeld. Zo ga je met dezelfde sleutel van een advertentie naar de winkel, en daarna naar het verkeer en de bestsellers van de winkel.

De volledige lijst staat in de API-documentatie. Klik je liever dan dat je codeert, dan werken dezelfde zoekopdrachten in onze advertentie-spytool.

Haal een API-sleutel op en stuur je eerste verzoek

1. Maak een account aan, bevestig je e-mailadres en kies een betaald abonnement: daar begint de API.
2. Open API-sleutels in je dashboard en maak een sleutel. Kopieer hem meteen: hij wordt maar één keer getoond.
3. Stuur de sleutel bij elk verzoek mee, in de header X-API-Key of als bearer-token.

Dit verzoek vindt videoadvertenties voor huidverzorging die nog lopen. Het werkt op elk betaald abonnement:

# 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 Parameters en velden in de documentatie

Het antwoord bevat een requestId, de advertenties onder data en een object pagination. In elke advertentie bevat media de URL's van de miniatuur en de video, content de kop, tekst, call-to-action en landingspagina, en advertiser de pagina die de advertentie draait. metrics telt de duplicaten en voegt bereik en geschatte uitgaven toe.

Een zoekopdracht op Meta geeft één advertentie per merk terug, zodat één adverteerder de pagina niet kan vullen. Verhoog maxAdsPerBrand (tot 15, of 0 voor geen limiet) om van elk merk meer te zien.

Filter op naam

Meta-advertenties hebben 111 benoemde filters, meegestuurd als queryparameters bij een GET of als bodyvelden bij een POST. Veelgebruikte zijn minDaysRunning, countries, cta en minDuplicates. Een verkeerd gespelde naam krijgt een 400 validation_failed met de namen die het endpoint accepteert, zodat een typfout nooit ongefilterde advertenties oplevert.

# 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 Parameters en velden in de documentatie

Bereik betekent bereik in de EU en het VK, en uitgaven zijn altijd een schatting.

Alle advertenties van één merk

Vind het adverteerders-ID van het merk met GET /v1/lookup?q=allbirds.com&type=advertiser, en toon daarna de advertenties, de langstlopende eerst:

# 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 Parameters en velden in de documentatie

Onze pagina over de Meta-advertentiebibliotheek behandelt deze weergave in de web-app, samen met de formatmix en de landingspagina's van het merk.

Blader door de resultaten

Zoekopdrachten nemen limit (tot 100) en page of offset. Herhaal voor de volgende pagina het verzoek met page plus één, of offset plus limit. Stop wanneer hasMore gelijk is aan false.

Paginering bereikt de eerste 5.000 resultaten van een zoekopdracht (bij een zoekopdracht naar adverteerders de eerste 100). Wil je verder, voeg dan filters toe of verander de sortering. Het meeste onderzoek heeft de top van een goed gefilterde lijst nodig, niet pagina 200.

Snelheidslimieten en credits per abonnement

1 credit = 1 geretourneerd resultaat: de details van één merk, één advertentie of één rij van een lijst. Een leeg resultaat is gratis. Fouten, weigeringen, lookups en filterwaarden kosten niets, en een MCP-toolaanroep kost wat hij aan resultaten oplevert, net als de API. Iedereen in een werkruimte, de sleutels ervan, de API en de MCP-server delen één pool credits en één snelheidslimiet. De maandelijkse credits worden vernieuwd om 00:00 UTC op de 1e van elke maand; opwaardeercredits die je op de factureringspagina koopt, blijven staan.

Elk antwoord bevat X-RateLimit-Remaining en X-Credits-Remaining, en X-Usage-Cost zegt wat de aanroep kostte, zodat je code kan vertragen voordat hij wordt geweigerd. Boven de limiet per minuut krijg je 429 rate_limited met een Retry-After in seconden. Zodra de maandelijkse credits en eventuele opwaardeercredits op zijn, krijg je 402 insufficient_credits tot de credits worden vernieuwd. GET /v1/usage laat zien waar je staat en kost niets. Meer daarover lees je bij snelheidslimieten en credits.

Doorzoek advertenties vanuit een AI-agent met de MCP-server

De MCP-server geeft een AI-agent dezelfde data als tools, via streamable HTTP, met je API-sleutel in de header X-API-Key. De pagina over onze MCP-server voor AI-agents bevat de server-URL en kant-en-klare configuraties voor Cursor, VS Code en Claude Desktop.

Voor advertentieonderzoek roept de agent vooral search_ads aan, scan_ad om één advertentie te openen, search_google_ads_library, search_tiktok_library en search_advertisers. Je vraagt het in gewone woorden: 'Vind videoadvertenties voor huidverzorging die nog lopen in de VS, open de drie die het langst lopen en noem hun hooks.' De agent zet dat om in filters en aanroepen. De regels van het abonnement zijn dezelfde als bij de API.

Hoe dit verschilt van de Ad Library API van Meta

SellWinners is niet de officiële API van Meta. Het is een onafhankelijke dienst en is niet gelieerd aan Meta. Meta heeft een eigen Ad Library API. Op de pagina over de tools van zijn advertentiebibliotheek ('Meta Ad Library tools' in het Transparantiecentrum) zegt Meta dat de API 'een diepere analyse mogelijk maakt van advertenties over maatschappelijke kwesties, verkiezingen of politiek, en van advertenties die in de EU en bijbehorende gebieden worden weergegeven', en spreekt het van 'geautoriseerde gebruikers'. We hebben die pagina op 19 oktober 2026 gecontroleerd.

De twee dienen ander werk. De API van Meta wordt beheerd door Meta, volgens de regels van Meta. SellWinners is gebouwd voor e-commerceonderzoek:

• Eén sleutel voor Meta-, Google- en TikTok-advertenties, met dezelfde paginering, fouten en limieten.
• Advertenties gekoppeld aan het merk erachter: de adverteerderspagina, en de Shopify-winkel als die er is.
• Filters waarmee je advertenties vindt die blijven lopen: dagen actief, duplicaten, call-to-action en advertentierang.
• Een MCP-server, zodat een AI-agent de zoekopdrachten voor je kan uitvoeren.
• Bereik voor advertenties die in de EU en het VK worden getoond, en geschatte uitgaven.

Gaat je werk over politieke of maatschappelijke advertenties, dan is de eigen API van Meta daarvoor gemaakt. Wil je zien wat e-commercemerken op drie netwerken draaien, en welke winkels achter de advertenties zitten, dan is dat precies wat SellWinners doet.

Waar je daarna naartoe gaat

Begin met één vraag, zoals welke huidverzorgingsmerken dezelfde video al een maand laten lopen. Voer hem één keer uit met curl en zet hem daarna in je code. Wil je dieper ingaan op één platform, open dan de TikTok-advertentiebibliotheek, de Google-advertentiebibliotheek of de zoekfunctie voor adverteerders. Wil je één concurrent volgen, gebruik dan de Merktracker om de advertenties van een merk door de tijd te volgen. Zie voor de bredere markt hoe advertentie-spytools zich tot elkaar verhouden.

Zoek advertenties in Verkennen