Eine Ad-Library-API für Meta-, Google- und TikTok-Anzeigen

Jede Suche nutzt denselben Schlüssel, dieselbe Paginierung und dieselben Fehlercodes und antwortet in JSON. Rufen Sie sie aus einem Skript oder Ihrer eigenen App auf, oder lassen Sie einen KI-Agenten sie über den MCP-Server aufrufen.

Meta-Anzeigen, Google-Anzeigen und TikTok in einer Ad-Library-API

Hinter dem Schlüssel stehen drei Anzeigen-Datenbereiche. Meta-Anzeigen umfassen Facebook und Instagram, und Sie durchsuchen sie nach Wörtern im Text, in der Marke oder auf der Landingpage. Google-Anzeigen liegen als Text-, Bild- und Videoanzeigen vor, mit einem Filter für das Netzwerk, in dem sie liefen, einschließlich YouTube. Eine Videoanzeige verlinkt auf das Ads Transparency Center von Google, wo sie abgespielt wird. TikTok liefert Ihnen Anzeigen und organische Posts in einer Suche, mit ihren Aufrufen, Likes und Shares.

Jede Anzeige verweist auf die Marke dahinter: die Werbetreibendenseite und, falls vorhanden, den damit verknüpften Shopify-Shop. So gelangen Sie mit demselben Schlüssel von einer Anzeige zum Shop und dann zum Traffic und zu den Bestsellern des Shops.

Die vollständige Liste steht in der API-Dokumentation. Wenn Sie lieber klicken als programmieren, laufen dieselben Suchen in unserem Ad-Spy-Tool.

API-Schlüssel holen und die erste Anfrage senden

1. Erstellen Sie ein Konto, bestätigen Sie Ihre E-Mail-Adresse und wählen Sie einen kostenpflichtigen Tarif: Dort beginnt die API.
2. Öffnen Sie API-Schlüssel in Ihrem Dashboard und erstellen Sie einen Schlüssel. Kopieren Sie ihn sofort: Er wird nur einmal angezeigt.
3. Senden Sie den Schlüssel bei jeder Anfrage mit, im Header X-API-Key oder als Bearer-Token.

Diese Anfrage findet Hautpflege-Videoanzeigen, die noch laufen. Sie funktioniert in jedem kostenpflichtigen Tarif:

# 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 und Felder in der Doku

Die Antwort enthält eine requestId, die Anzeigen unter data und ein pagination-Objekt. In jeder Anzeige enthält media die Vorschaubild- und Video-URLs, content die Überschrift, den Text, den Call-to-Action und die Landingpage und advertiser die Seite, die sie schaltet. metrics zählt die Duplikate und ergänzt Reichweite und geschätzte Ausgaben.

Eine Meta-Suche liefert eine Anzeige pro Marke, damit nicht ein einzelner Werbetreibender die ganze Seite füllt. Erhöhen Sie maxAdsPerBrand (bis 15, oder 0 für keine Begrenzung), um mehr von jeder Marke zu sehen.

Nach Name filtern

Meta-Anzeigen nehmen 111 benannte Filter an, gesendet als Query-Parameter bei einem GET oder als Body-Felder bei einem POST. Gängige sind minDaysRunning, countries, cta und minDuplicates. Ein falsch geschriebener Name erhält ein 400 validation_failed, das die Namen auflistet, die der Endpunkt annimmt, sodass ein Tippfehler nie ungefilterte Anzeigen liefert.

# 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 und Felder in der Doku

Reichweite bedeutet Reichweite in der EU und im Vereinigten Königreich, und die Ausgaben sind immer eine Schätzung.

Alle Anzeigen einer Marke

Ermitteln Sie die Werbetreibenden-ID der Marke mit GET /v1/lookup?q=allbirds.com&type=advertiser und listen Sie dann ihre Anzeigen auf, die am längsten laufenden zuerst:

# 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 und Felder in der Doku

Unsere Seite zur Suche in der Meta-Anzeigenbibliothek behandelt diese Ansicht in der Web-App, zusammen mit dem Formatmix und den Landingpages der Marke.

Durch die Ergebnisse blättern

Suchen nehmen limit (bis 100) und entweder page oder offset an. Für die nächste Seite wiederholen Sie die Anfrage mit page plus eins oder offset plus limit. Hören Sie auf, wenn hasMore den Wert false hat.

Die Paginierung reicht bis zu den ersten 5.000 Ergebnissen einer Suche (bei einer Werbetreibenden-Suche bis zu den ersten 100). Um weiterzukommen, fügen Sie Filter hinzu oder ändern Sie die Sortierung. Die meiste Recherche braucht den Anfang einer gut gefilterten Liste, nicht Seite 200.

Ratenlimits und Credits nach Tarif

1 Credit = 1 zurückgegebenes Ergebnis: die Details einer Marke, eine Anzeige oder eine Zeile einer Liste. Ein leeres Ergebnis ist kostenlos. Fehler, Ablehnungen, Lookups und Filterwerte kosten nichts, und ein MCP-Tool-Aufruf kostet so viele Credits, wie er Ergebnisse zurückgibt, genau wie bei der API. Alle Mitglieder eines Arbeitsbereichs, seine Schlüssel, die API und der MCP-Server teilen sich einen Pool an Credits und ein Ratenlimit. Die monatlichen Credits erneuern sich am 1. jedes Monats um 00:00 UTC; auf der Abrechnungsseite gekaufte aufgeladene Credits werden übertragen.

Jede Antwort enthält X-RateLimit-Remaining und X-Credits-Remaining, und X-Usage-Cost sagt, was der Aufruf gekostet hat, sodass Ihr Code langsamer werden kann, bevor er abgelehnt wird. Über dem Limit pro Minute erhalten Sie 429 rate_limited mit einem Retry-After in Sekunden. Sobald die monatlichen Credits und etwaige aufgeladene Credits verbraucht sind, erhalten Sie 402 insufficient_credits, bis sich die Credits erneuern. GET /v1/usage zeigt Ihren aktuellen Stand und kostet nichts. Mehr dazu unter Ratenlimits und Credits.

Anzeigen von einem KI-Agenten aus mit dem MCP-Server durchsuchen

Der MCP-Server stellt einem KI-Agenten dieselben Daten als Tools bereit, über Streamable HTTP, mit Ihrem API-Schlüssel im Header X-API-Key. Die Seite zu unserem MCP-Server für KI-Agenten enthält die Server-URL und fertige Konfigurationen für Cursor, VS Code und Claude Desktop.

Für die Anzeigenrecherche ruft der Agent vor allem search_ads auf, scan_ad, um eine Anzeige zu öffnen, search_google_ads_library, search_tiktok_library und search_advertisers. Sie fragen in normalen Worten: »Finde Hautpflege-Videoanzeigen, die in den USA noch laufen, öffne die drei, die am längsten laufen, und liste ihre Hooks auf.« Der Agent macht daraus Filter und Aufrufe. Die Tarifregeln sind dieselben wie bei der API.

Wie sich das von der Ad Library API von Meta unterscheidet

SellWinners ist nicht die offizielle API von Meta. Es ist ein unabhängiger Dienst und nicht mit Meta verbunden. Meta betreibt eine eigene Ad Library API. Auf seiner Seite zu den Tools der Werbebibliothek (»Meta Ad Library tools« in seinem Transparency Center) sagt Meta, die API »ermöglicht eine tiefere Analyse von Anzeigen zu gesellschaftlichen Themen, Wahlen oder Politik sowie von Anzeigen, die in der EU und den zugehörigen Gebieten ausgeliefert werden«, und spricht von »autorisierten Nutzern«. Wir haben diese Seite am 19. Oktober 2026 geprüft.

Die beiden dienen unterschiedlichen Aufgaben. Die API von Meta wird von Meta betrieben, nach den Regeln von Meta. SellWinners ist für die E-Commerce-Recherche gebaut:

• Ein Schlüssel für Meta-, Google- und TikTok-Anzeigen, mit derselben Paginierung, denselben Fehlern und denselben Limits.
• Anzeigen, die mit der Marke dahinter verknüpft sind: mit der Werbetreibendenseite und, falls vorhanden, mit dem Shopify-Shop.
• Filter, mit denen Sie Anzeigen erkennen, die weiterlaufen: Tage aktiv, Duplikate, Call-to-Action und Anzeigenrang.
• Ein MCP-Server, damit ein KI-Agent die Suchen für Sie ausführen kann.
• Reichweite für in der EU und im Vereinigten Königreich gezeigte Anzeigen und geschätzte Ausgaben.

Wenn es bei Ihrer Arbeit um politische oder themenbezogene Anzeigen geht, ist die eigene API von Meta dafür gemacht. Wenn Sie sehen möchten, was E-Commerce-Marken auf drei Netzwerken schalten und welche Shops hinter den Anzeigen stehen, ist das die Aufgabe von SellWinners.

Wie es weitergeht

Beginnen Sie mit einer Frage, etwa welche Hautpflegemarken dasselbe Video seit einem Monat laufen lassen. Führen Sie sie einmal mit curl aus und übernehmen Sie sie dann in Ihren Code. Um bei einer Plattform tiefer einzusteigen, öffnen Sie die TikTok-Anzeigenbibliothek, die Google-Anzeigenbibliothek oder die Werbetreibenden-Suche. Um einen einzelnen Wettbewerber zu beobachten, können Sie die Anzeigen einer Marke im Zeitverlauf verfolgen. Einen Überblick über den breiteren Markt finden Sie in unserem Vergleich der Ad-Spy-Tools.

Anzeigen in Entdecken durchsuchen