Bild des TikTok Ad Library ScrapersBibliothek kommerzieller Inhalte

TikTok Ad Library Scraper.

Sammle TikTok-Anzeigen in EU/EWR, Großbritannien und der Schweiz. Sieh die Videos an, vergleiche Angebote und Werbeaktivität und plane Tests für deine Zielgruppe.

Auf Apify starten

So kannst du diesen Scraper nutzen.

Probiere diese Beispiele für Marketing, Wachstum und Wettbewerbsrecherche.

01

Plane einen Videotest für eine Produktkategorie

Sammle für eine Beauty-Kampagne in Frankreich Kategorieanzeigen und prüfe die Videos. Markiere Einstiege, Demonstrationen und Angebote selbst und wähle Testansätze.

Halte Referenzen und ausgewählte Storyboard-Ideen in einer Tabelle fest.

02

Prüfe Motive vor dem Eintritt in einen neuen Markt

Vergleiche öffentliche Anzeigen in Deutschland und Spanien. Prüfe Werbetreibende, Inhalte und Sprachen vor lokaler Produktion.

Speichere Quellvideos im Marktbriefing mit noch offenen Lokalisierungsfragen.

03

Finde Creator in kommerziellen Markeninhalten

Suche einen Markennamen und prüfe, ob Datensätze zur registrierten Marke oder einem Creator gehören. Behalte beide Identitäten.

Nutze Werbetreibenden- und Creator-Listen für Partnerrecherche.

VOM ERSTEN LAUF ZUM REGELMÄSSIGEN ABLAUF

Ihr erster Lauf, Schritt für Schritt.

  1. Öffnen Sie den Actor auf Apify, wählen Sie Input und wechseln Sie zum JSON-Editor, um eine Konfiguration einzufügen.
  2. Ersetze die gesamte JSON-Eingabe durch das Beispiel und Nike durch deinen Werbetreibenden. Ein Anzeigename kann zu mehreren juristischen Namen passen; nutze advertiserBusinessIds, nachdem du die ID in einem Ergebnis geprüft hast.
  3. Wähle ein unterstütztes Land wie FR und maxAds 50. Lass Residential-Proxys aktiviert. Entferne die vorbelegte Region GB, wenn du nur Frankreich möchtest. Ergänze Zielgruppenfilter erst, wenn die erste Suche funktioniert.
  4. Starten Sie den Lauf und prüfen Sie das Protokoll. Kontrollieren Sie die erkannten Ziele und Filter, bevor Sie aus leeren Ergebnissen auf fehlende Daten schließen.
  5. Öffnen Sie Storage → Dataset, prüfen Sie mehrere Datensätze und exportieren Sie verschachtelte Daten als JSON oder einfache Tabellen als CSV.
Konfiguration für den ersten Lauf
{
  "searchTerms": ["Nike"],
  "regions": ["FR"],
  "maxAds": 50,
  "adStatus": "all",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Fügen Sie dies in den JSON-Eingabeeditor des Actors ein. Ersetzen Sie die Beispielziele vor dem Start.

Das aktuelle Eingabeformular auf Apify ansehen

Wählen Sie die passende Suche.

Dies ist TikToks Commercial Content Library für EU/EWR, Großbritannien und die Schweiz. Sie eignet sich zur Recherche von Werbetreibenden in diesen Märkten. Für kreative Beispiele aus den USA nutze den Creative-Center-Scraper.

SuchmethodeWann es sinnvoll istWas sich ändert
Werbetreibender oder MarkennameWann es sinnvoll istDu hast eine Liste von Wettbewerbern.Was sich ändertSuchen Sie Werbetreibende, oft unter juristischem Namen. Teilnamen, TikTok-Profile und Websites können eine Marke identifizieren. Ohne Treffer kann eine Stichwortsuche folgen.
Suche nach KeywordsWann es sinnvoll istDu möchtest passende Ergebnisse finden, bevor du konkrete Ziele auswählst.Was sich ändertSuchen Sie Themen wie running shoes im Anzeigeninhalt, unabhängig vom Werbetreibenden. So finden Sie bislang unbekannte Unternehmen.
Werbetreibenden-IDsWann es sinnvoll istDu kennst genau die Entität, deren Daten du sammeln möchtest.Was sich ändertNumerische TikTok-Unternehmens-IDs für genaue Zuordnung ohne Namenssuche. Kopieren Sie eine geprüfte ID; verwenden Sie keinen TikTok-Nutzernamen.
URLs der WerbebibliothekWann es sinnvoll istDu hast die Suche bereits auf der Quellwebsite eingerichtet.Was sich ändertFügen Sie Suchlinks von library.tiktok.com ein. Länder, Daten, Status und Zielgruppenfilter der URL haben Vorrang; einzelne Felder ergänzen fehlende Werte.

Der entscheidende Unterschied

Abgedeckt werden nur die 32 aufgeführten Märkte: EU/EWR, Großbritannien und die Schweiz. Angegebene Länder werden einzeln gesucht. Eine leere regions-Liste sucht alle Märkte gemeinsam; ["all"] sucht jedes Land einzeln. Nicht unterstützte Länder werden übersprungen. Bleibt keines übrig, werden alle unterstützten Märkte durchsucht.

Den verwandten Scraper vergleichen

Alle Eingaben erklärt.

Verwenden Sie in JSON die genauen Feldnamen unten. Geben Sie Listenwerte im Apify-Formular einzeln ein und verwenden Sie Zahlen und Wahrheitswerte im richtigen Datentyp.

Standardwert und Vorbelegung sind verschieden. Der Standardwert gilt, wenn du eine Einstellung auslässt; die Vorbelegung ist ein Beispiel im Apify-Formular. Prüfe Ziele und Limits vor jedem Lauf. Manche Einstellungen haben keinen Standardwert im Schema. Du musst trotzdem mindestens ein unterstütztes Ziel angeben.

Ziele und Suchbegriffe5
searchTerms
ListeIm Formular vorausgefüllt: ["Nike"]

Suchen Sie Werbetreibende, oft unter juristischem Namen. Teilnamen, TikTok-Profile und Websites können eine Marke identifizieren. Ohne Treffer kann eine Stichwortsuche folgen.

searchTerm
Text

Ein Werbetreibender statt searchTerms. Nutzen Sie die Liste für mehrere Wettbewerber und advertiserBusinessIds für eine bekannte genaue Identität.

keywords
Liste

Suchen Sie Themen wie running shoes im Anzeigeninhalt, unabhängig vom Werbetreibenden. So finden Sie bislang unbekannte Unternehmen.

advertiserBusinessIds
Liste

Numerische TikTok-Unternehmens-IDs für genaue Zuordnung ohne Namenssuche. Kopieren Sie eine geprüfte ID; verwenden Sie keinen TikTok-Nutzernamen.

adLibraryUrls
Liste

Fügen Sie Suchlinks von library.tiktok.com ein. Länder, Daten, Status und Zielgruppenfilter der URL haben Vorrang; einzelne Felder ergänzen fehlende Werte.

Märkte, Zeiträume und Filter10
regions
ListeIm Formular vorausgefüllt: ["GB"]

Abgedeckt werden nur die 32 aufgeführten Märkte: EU/EWR, Großbritannien und die Schweiz. Angegebene Länder werden einzeln gesucht. Eine leere regions-Liste sucht alle Märkte gemeinsam; ["all"] sucht jedes Land einzeln. Nicht unterstützte Länder werden übersprungen. Bleibt keines übrig, werden alle unterstützten Märkte durchsucht.

Vorgeschlagene JSON-Werte
AT BE BG CH CY CZ DE DK EE ES FI FR GB GR HR HU IE IS IT LI LT LU LV MT NL NO PL PT RO SE SI SK all
region
Text

Ein Land zusätzlich zu oder statt regions. Anders als bei Google Ads wird es mit der Liste kombiniert, nicht nur bei leerer Liste genutzt.

Vorgeschlagene JSON-Werte
AT BE BG CH CY CZ DE DK EE ES FI FR GB GR HR HU IE IS IT LI LT LU LV MT NL NO PL PT RO SE SI SK
minDate
Text

Filtert serverseitig das letzte Auslieferungsdatum, nicht die Erstellung. Nutzen Sie YYYY-MM-DD; ohne Daten wird das verfügbare Archiv statt der 30-Tage-Websiteansicht erfasst.

maxDate
Text

Das letzte Auslieferungsdatum liegt spätestens an diesem Tag. Mit minDate entsteht ein Zeitraum letzter Auslieferungen; ältere Anzeigen können passen.

adType
TextStandard: all

Wählen Sie all, video, image oder text. Filtert das Creative-Format, nicht politische oder kommerzielle Anzeigen.

Vorgeschlagene JSON-Werte
all video image text
adStatus
TextStandard: all

active bedeutet aktuell laufend, inactive gestoppt, all beides. Status und letztes Auslieferungsdatum beantworten unterschiedliche Fragen; wählen Sie beide bewusst.

Vorgeschlagene JSON-Werte
all active inactive
sortBy
TextStandard: last_shown_date,desc

Sortieren Sie nach letzter Auslieferung, Veröffentlichung oder eindeutiger Reichweite, auf- oder absteigend. Mit maxAds bestimmt dies den zuerst erfassten Ausschnitt.

Vorgeschlagene JSON-Werte
last_shown_date,desc last_shown_date,asc create_time,desc create_time,asc impression,desc impression,asc
gender
TextStandard: ALL

Filtert das erklärte Zielgeschlecht: ALL, FEMALE oder MALE. Dies sind Zielgruppenangaben, keine gemessene Verteilung tatsächlicher Betrachter.

Vorgeschlagene JSON-Werte
ALL FEMALE MALE
ages
Liste

Zielaltersgruppen als Liste von Zeichenketten. Nutzen Sie Kommawerte wie 18,24. Leer umfasst alle Altersgruppen; es sind keine gemessenen Zuschauer.

Vorgeschlagene JSON-Werte
all 13,17 18,24 25,34 35,44 45,54 55,100
adReach
Liste

Wählen Sie öffentliche Reichweitenbereiche: 0-10K, 10K-100K oder 100K+. Leer umfasst alle. Bereiche sind keine genauen Impressionen oder Conversions.

Vorgeschlagene JSON-Werte
all 0-10K 10K-100K 100K+
Grenzen, Details und Proxys5
proxyConfiguration
ObjektStandard: {"useApifyProxy":true,"apifyProxyGroups":["RESIDENTIAL"]}Im Formular vorausgefüllt: {"useApifyProxy":true,"apifyProxyGroups":["RESIDENTIAL"]}

Residential Proxys sind erforderlich. Datacenter-Adressen können bereits beim Sitzungsaufbau ohne klare Meldung scheitern. Behalten Sie RESIDENTIAL bei, bevor Sie Filter zur Diagnose ändern.

maxAds
GanzzahlIm Formular vorausgefüllt: 500

Feste Grenze für eindeutige Anzeigen im gesamten Lauf, über alle Ziele und Märkte. Beginnen Sie mit 50. Ohne diese Grenze kann eine breite Suche sehr groß werden.

maxPages
Ganzzahl

Begrenzt Seiten je Land und Suche. Eine Seite enthält effektiv höchstens 12 Anzeigen, auch wenn ältere Beschreibungen mehr nennen. Leer ermöglicht weitere Seiten bis zur Ergebnisgrenze.

pageSize
GanzzahlStandard: 12

1 bis 12 Anzeigen je Anfrage. Höhere Werte werden zu 12. maxPages erhöht die Tiefe; pageSize über 12 nicht.

delayMs
GanzzahlStandard: 500

Pause zwischen Seitenanfragen in Millisekunden. Erhöhen Sie sie bei Drosselung; eine Verringerung hebt weder Netzwerklatenz noch Quelllimits auf.

Erweiterte Einstellungen und Wiederaufnahme4
raw
Wahr oder falschStandard: false

Gibt TikToks unveränderte Datensätze ohne Datumsumwandlung und Medien-URL-Decodierung zurück. Nutzen Sie false für tabellenfertige Daten.

proxyRotations
GanzzahlStandard: 3

Wiederholt verweigerte Aufgaben mit einer neuen Proxy-Sitzung. Weitere Versuche können vorübergehende Sperren überwinden, erhöhen aber Dauer und Datenverkehr. Ändern Sie den Standard nur bei Hinweisen im Protokoll.

resume
Wahr oder falschStandard: true

Speichert den Fortschritt etwa alle 30 Sekunden für Neustarts oder Migrationen durch Apify. Lassen Sie es normalerweise aktiviert.

continueFromLastRun
Wahr oder falschStandard: false

Setzt unerledigte Arbeit des vorherigen Laufs mit passender Eingabe fort. Bisherige Daten bleiben in dessen Dataset. Nutzen Sie false für neue oder regelmäßige Erhebungen.

Diese Referenz folgt den Eingabefeldern des Actors. Prüfen Sie das aktuelle Formular, bevor Sie einen produktiven Ablauf ändern. Das aktuelle Eingabeformular auf Apify ansehen.

Konfigurationen zum Kopieren.

Jedes Beispiel ist ein eigener Lauf. Beginnen Sie klein, prüfen Sie die Ergebnisse und erweitern Sie dann. Passen Sie Ziele, Länder und Zeiträume an Ihre Frage an.

Aktive Anzeigen eines Werbetreibenden verfolgen

Sammle bis zu 50 aktive Anzeigen aus Großbritannien. Prüfe die juristischen Werbetreibendennamen vor der Planung und behalte Land und Filter für jede wöchentliche Erhebung bei.

Aktive Anzeigen eines Werbetreibenden verfolgen
{
  "searchTerms": ["Nike"],
  "regions": ["GB"],
  "adStatus": "active",
  "maxAds": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Ein bestimmtes Anzeigensegment erkunden

Suche Skincare-Videoanzeigen in Frankreich für 25- bis 34-Jährige mit der Reichweitenklasse 100K+. Die Stichprobe kann klein oder leer sein. Entferne Reichweiten- und Altersfilter einzeln, wenn du breiter suchen möchtest.

Ein bestimmtes Anzeigensegment erkunden
{
  "keywords": ["skincare"],
  "regions": ["FR"],
  "adType": "video",
  "ages": ["25,34"],
  "adReach": ["100K+"],
  "sortBy": "last_shown_date,desc",
  "maxAds": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Die Auslieferung in zwei Ländern vergleichen

Suche in Deutschland und Frankreich mit einem Zeitraum für die letzte Auslieferung. Dieselbe Anzeige kann in beiden Suchen vorkommen und wird einmal gespeichert. Addiere Länderzahlen nicht wie getrennte Anzeigenbestände.

Die Auslieferung in zwei Ländern vergleichen
{
  "searchTerms": ["Nike"],
  "regions": ["DE", "FR"],
  "minDate": "2026-09-01",
  "maxDate": "2026-09-30",
  "maxAds": 100,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Ausführen, prüfen, exportieren, wiederholen.

Behalte Anzeigen-ID, juristischen Namen, Quell-URL, Medien und erste/letzte Auslieferung. Reichweite kann als Band vorliegen, Ausgaben und Impressionen können fehlen. Die Daten zeigen keine Conversions und beweisen keinen Erfolg. Sichere Medienreferenzen zeitnah, da URLs ablaufen können, und bewahre den Ländersuchkontext.

  1. Prüfen Sie Dataset und SUMMARY. Vergleichen Sie die Anzahl mit Ihrer Grenze, kontrollieren Sie fehlgeschlagene oder übersprungene Eingaben und einige Quelllinks.
  2. Behalten Sie Original-IDs und ergänzen Sie collected_at und run_id beim Speichern. Nutzen Sie CSV für einfache Spalten und JSON für Listen oder verschachtelte Details.
  3. Speichern Sie die geprüfte Konfiguration als Apify Task und planen Sie sie ein. Lassen Sie continueFromLastRun für regelmäßige Momentaufnahmen auf false. Bereinigen Sie Duplikate anhand der Quell-ID und behalten Sie Beobachtungsdaten.
  4. Warten Sie in Make oder n8n auf einen abgeschlossenen Lauf, lesen Sie dessen Dataset und ordnen Sie Felder Sheets oder dem Warehouse zu. Versorgen Sie Looker Studio über eine Berichtstabelle; nutzen Sie dbt für Transformation und Tests.
  5. Dasselbe JSON funktioniert mit der Actor-API von Apify. Nennen Sie in Claude mit Apify MCP diesen Actor, lassen Sie das Schema prüfen und geben Sie vor dem Start Ziele, Märkte und Grenzen an.

Wiederaufnahme ist keine neue Momentaufnahme

resume schützt den aktuellen Lauf bei einem Neustart durch Apify. continueFromLastRun setzt einen früheren Lauf mit derselben Konfiguration fort; vorhandene Daten bleiben im alten Dataset. Führen Sie beide Datasets zusammen und erhöhen Sie erreichte Grenzen. Starten Sie neu, um heutige Änderungen zu erfassen.

Die Anleitungen für Sheets, Claude, Looker und BigQuery lesen
Diesen Actor über die API starten

Speichere eine Konfiguration oben als input.json. Setze APIFY_TOKEN im Terminal auf deinen Apify-API-Token und sende die Datei als Anfrageinhalt.

Lauf starten
curl --fail-with-body --request POST \
  --url "https://api.apify.com/v2/actors/jmlp~tiktok-ad-library-scraper/runs" \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header "Content-Type: application/json" \
  --data-binary @input.json

Die Antwort enthält eine Run-ID und defaultDatasetId, keine fertigen Ergebnisse. Warte auf einen erfolgreichen Abschluss, setze DATASET_ID auf diese Dataset-ID und rufe die Einträge ab. Nutze bei großen Datensätzen limit und offset zur Paginierung.

Datensatz abrufen
curl --fail-with-body \
  --url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
  --header "Authorization: Bearer $APIFY_TOKEN"

Apifys API-Referenz für Start und Export
Optionen für den Datenexport

Wenn die Ergebnisse nicht stimmen.

Ändern Sie jeweils nur eine Einstellung, behalten Sie eine kleine Grenze und prüfen Sie die Zusammenfassung vor einer Erweiterung.

Das ausgewählte Land liefert keine brauchbaren Ergebnisse.

Abgedeckt werden nur die 32 aufgeführten Märkte: EU/EWR, Großbritannien und die Schweiz. Angegebene Länder werden einzeln gesucht. Eine leere regions-Liste sucht alle Märkte gemeinsam; ["all"] sucht jedes Land einzeln. Nicht unterstützte Länder werden übersprungen. Bleibt keines übrig, werden alle unterstützten Märkte durchsucht.

Die Quelle liefert leere Seiten oder Zugriffsfehler.

Residential Proxys sind erforderlich. Datacenter-Adressen können bereits beim Sitzungsaufbau ohne klare Meldung scheitern. Behalten Sie RESIDENTIAL bei, bevor Sie Filter zur Diagnose ändern.

Warum sind Ausgaben- oder Leistungsfelder leer?

Behalte Anzeigen-ID, juristischen Namen, Quell-URL, Medien und erste/letzte Auslieferung. Reichweite kann als Band vorliegen, Ausgaben und Impressionen können fehlen. Die Daten zeigen keine Conversions und beweisen keinen Erfolg. Sichere Medienreferenzen zeitnah, da URLs ablaufen können, und bewahre den Ländersuchkontext.

Der Lauf war erfolgreich, hat aber keine Ergebnisse

Erfolg bedeutet, dass der Actor die Anfrage bearbeitet hat, nicht dass die Quelle Daten geliefert hat. Prüfen Sie SUMMARY.inputProblem, SUMMARY.problem und das Protokoll auf fehlende Ziele, ungültige Filter oder verweigerte Anfragen. Testen Sie ein bekanntes Ziel mit weniger Filtern.

Weniger Datensätze als erwartet

Prüfen Sie globale Grenzen, Such- und Seitengrenzen, Abdeckung und Duplikate. Mehrere Suchen können denselben Datensatz finden. Die angezeigte Gesamtzahl der Quelle kann öffentlich nicht verfügbare Datensätze enthalten. Prüfen Sie offene Aufgaben, bevor Sie den Bestand als vollständig ansehen.

Nutze die Ergebnisse in deinen Tools.

Google Sheets

Ergänze ad_id, advertiser_name, scraped_region, first_shown, last_shown und media_url. Prüfe Videos vor eigenen Hook-, Format- und Produktlabels.

Anleitung lesen
Claude + MCP

Lass Claude Metadaten ordnen und Quellen zitieren. Gib Medien oder Transkripte über einen unterstützten Ablauf für Videoanalyse. Metadaten allein zeigen keinen Einstieg.

Anleitung lesen
Looker Studio

Vergleiche Aktivität nach Werbetreibendem und Region. Behalte Reichweitenbereiche und addiere wiederholte regionale Beobachtungen nicht als einzigartige Personen.

Anleitung lesen
BigQuery + dbt

Behalte Rohbeobachtungen und eine Kreativtabelle mit ad_id. Speichere regionale Beobachtungen separat mit Original-Reichweitenbereichen.

Anleitung lesen
Prompt für Claude kopieren
Prompt für Claude + Apify MCP
Prüfe jmlp/tiktok-ad-library-scraper und sammle bis zu 50 Nike-bezogene Datensätze in FR. Trenne Werbetreibende von Creator-Handles, fasse Daten und Reichweitenbereiche zusammen und zitiere ad_library_url. Markiere fehlende Ausgaben und Impressionen. Beschreibe keine ungeprüften Videos.

Diese Felder erhältst du.

Behalte Erfassungszeit und Original-IDs, um die Herkunft eines Ergebnisses zu prüfen oder spätere Läufe zu vergleichen.

Bevor du Schlüsse ziehst

Dieser Scraper deckt 32 unterstützte Märkte in EU/EWR, Großbritannien und der Schweiz ab. Ausgaben und Impressionen können fehlen; estimated_audience enthält verfügbare Reichweitenklassen. Diese und die Daten zeigen keine Conversions oder ROAS. Medienlinks können ablaufen.

ad_id / advertiser_business_id
Stabile IDs für Datensätze und Werbetreibendenbeobachtung.
advertiser_name
Gemeldetes Konto; bei Markeninhalten können Creator-Namen erscheinen.
first_shown / last_shown
Gemeldete Ausspielungsdaten im gewählten Land.
media_url / cover_url
Verfügbare Medien- und Vorschaubildlinks.
estimated_audience
Öffentlicher Reichweitenbereich der Bibliothek.
scraped_region / ad_library_url
Erfassungskontext und Quellenreferenz.

Häufige Fragen.

Kann ich den US-TikTok-Werbemarkt erfassen?

Dieser Actor erfasst die unterstützten Märkte der Commercial Content Library in EU/EWR, Großbritannien und der Schweiz. Er bietet keine US- oder weltweite Anzeigenabdeckung.

Kann Claude die Videos automatisch verstehen?

Der Scraper liefert Medienlinks und Metadaten. Videoanalyse benötigt das tatsächliche Medium oder ein Transkript und einen passenden Ablauf.

Quelle und aktuelle Produktdetails: JMLPs TikTok Ad Library Actor auf Apify.

Weitere Scraper,
die du nutzen könntest.

Sprechen wir über
dein Projekt.

Sag mir, was du sammeln oder verstehen möchtest. Ich helfe mit einem individuellen Scraper, einer Pipeline oder der Analyse.

Projekt besprechen