TikTok Ad Library Search
TikTok Ad Library Search sendet eine Anfrage mit einem Werbetreibenden-Namen oder Keyword an die öffentliche Ads Library und folgt deren undurchsichtigem Cursor, bis das seitenweise ausgerichtete Limit oder eine Abbruchbedingung der Quelle erreicht ist. Das unterstützt Transparenzrecherche und das Auffinden von Anzeigen, nicht die Verwaltung privater Kampagnen oder die Leistungsmessung.
Funktionen der TikTok Ad Library Search API
- Eine gezielte AnfrageSuchen Sie mit genau einem erforderlichen, nicht leeren Werbetreibenden-Namen, Markenbegriff oder Keyword.
- Seitenweise ausgerichtete ErfassungFordern Sie 12 bis 2.000 Ergebnisse in Vielfachen von 12 an; 1.992 ist der größte gültige Wert.
- Umgang mit undurchsichtigem CursorFolgt den Cursors der Quelle bis zum Limit, einer leeren Seite, einem Endsignal, einem fehlenden Cursor oder einem wiederholten Cursor.
- Normalisierte AnzeigenzusammenfassungenLiefert stabile Felder zu Identität, Werbetreibendem, Anzeigedatum, Auslieferung, Ziel, Impressionen, Medien, Veröffentlichung und Erfassung.
- Nullbarkeit nach QuelleFelder bleiben null oder leer, wenn das öffentliche Suchergebnis nur eine Zusammenfassung enthält oder den Wert auslässt.
Parameter der TikTok Ad Library Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, nicht leerer Werbetreibenden-Name oder Keyword. Es wird genau eine Anfrage akzeptiert. |
results_limit | Optional | Optionale Obergrenze für die Ergebnisse. Der Standardwert ist 12; der Wert muss ein Vielfaches von 12 zwischen 12 und 2.000 sein, der größte gültige Wert ist 1.992. |
So verwenden Sie die TikTok Ad Library Search API
Senden Sie eine Anfrage mit einem gültigen seitenweise ausgerichteten Limit, fragen Sie die asynchrone Aufgabe ab und verarbeiten Sie die normalisierten Ergebnisseiten.
- Wählen Sie einen Werbetreibenden-Namen oder ein Keyword; der Endpunkt akzeptiert keine Liste von Anfragen.
- Senden Sie query und optional results_limit per POST an /v1/tiktok-ad-library/search.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe einen Endstatus erreicht.
- Lesen Sie data.results.items und folgen Sie den Cursors des Aufgabenergebnisses, solange die Ergebnisantwort weitere Seiten meldet.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Anysphere","results_limit":12}'
# Poll GET /v1/tasks/{task_id}
# Read normalized ads from data.results.itemsAnwendungsfälle der TikTok Ad Library Search API
- Entdeckung von Werbetreibenden: Finden Sie unterstützte öffentliche Anzeigen zu einem übergebenen Werbetreibenden- oder Markennamen.
- Keyword-Recherche: Stellen Sie eine Prüfmenge öffentlicher Anzeigen zusammen, deren indexierte Bibliotheksinhalte zu einem Themenbegriff passen.
- Überblick über die Creative-Landschaft: Vergleichen Sie sichtbare Themen, Medienverweise, Bezeichnungen der Werbetreibenden und Anzeigedaten über die zurückgegebenen Datensätze hinweg.
- Warteschlange für Detailabfragen: Sammeln Sie öffentliche Anzeigen-IDs und Quellverweise, um ausgewählte Datensätze mit dem Detail-Endpunkt zu prüfen.
Profi-Tipps zur TikTok Ad Library Search API
- Verwenden Sie einen konkreten Werbetreibenden-Namen oder eine markante Wendung, denn Abgleich und Reihenfolge der Quelle bestimmen die Relevanz.
- Wählen Sie results_limit in Schritten von 12 Datensätzen; 2.000 liegt innerhalb der allgemeinen Obergrenze, verstößt aber gegen die Regel der Vielfachen von 12.
- Rechnen Sie mit weniger Datensätzen als angefordert, wenn die Quelle endet, eine leere Seite liefert oder einen Cursor wiederholt.
- Gehen Sie nicht von einer Deduplizierung über Seiten hinweg aus; verwenden Sie in Ihrer eigenen Pipeline die stabile Anzeigen-ID, wenn Eindeutigkeit wichtig ist.
- Behandeln Sie geschätzte Zielgruppen oder Impressionen gemäß der Definition der Quelle und nicht als Conversions oder überprüfte Leistung.
- Nutzen Sie den Endpunkt Ad Details für einen ausgewählten Datensatz; die Suche bietet keine optionale Anreicherung mit Details.
Verwandte APIs
Ergänzend zur TikTok Ad Library Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok Ad Library-Daten benötigen.
- TikTok Ad Library Ad API — Eine bekannte öffentliche TikTok-Anzeigen-URL in normalisierte Felder zu Creative, Werbetreibendem, Auslieferung, Ziel, Impressionen, Medien, Veröffentlichung und Erfassung auflösen.