tiktok-ad-library/
search

Unterstützte öffentliche TikTok-Werbeeinträge mit einer Anfrage nach Werbetreibenden-Name oder Keyword entdecken und anschließend normalisierte Identitäten, Anzeigedaten, Zielgruppensignale und Medienverweise erfassen, sofern verfügbar.

TikTok Ad Library Search API

Werbetreibender oder Keyword
Seiten mit 12 Datensätzen
Entdeckung öffentlicher Anzeigen
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, nicht leerer Werbetreibenden-Name oder Keyword. Es wird genau eine Anfrage akzeptiert.
results_limitOptionalOptionale 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.

  1. Wählen Sie einen Werbetreibenden-Namen oder ein Keyword; der Endpunkt akzeptiert keine Liste von Anfragen.
  2. Senden Sie query und optional results_limit per POST an /v1/tiktok-ad-library/search.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe einen Endstatus erreicht.
  4. 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.items

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie TikTok Ad Library-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

TikTok Ad Library Search API — FAQ

TikTok Ad Library Search API ist eine Schnittstelle, die mit einer Anfrage nach Werbetreibenden-Name oder Keyword unterstützte öffentliche TikTok-Werbeeinträge findet und normalisierte Anzeigenzusammenfassungen bis zu einem seitenweise ausgerichteten Limit zurückgibt.

query ist eine erforderliche, nicht leere Zeichenfolge. Sie kann ein Werbetreibenden-Name, ein Markenbegriff oder ein Keyword sein, doch der Endpunkt akzeptiert in einer Anfrage nicht mehrere Werte für query.

Der Standardwert ist 12. Die Werte müssen ganze Zahlen von 12 bis 2.000 und Vielfache von 12 sein, daher ist 1.992 das größte gültige Limit.

Nein. Die aktuelle Spezifikation von SocQ akzeptiert nur query und results_limit; Abgleich, Reihenfolge, Geografie und Zulässigkeit der Quelle bleiben Sache der Quelle.

Die Erfassung endet am angeforderten Limit oder wenn die Quelle keine Anzeigen liefert, die letzte Seite meldet, keinen Cursor angibt oder einen Cursor wiederholt. Auch Sichtbarkeits- und Geografieregeln können die Verfügbarkeit beeinflussen.

Der Collector verhindert Cursor-Schleifen, verspricht aber keine Deduplizierung von Datensätzen über Seiten hinweg. Deduplizieren Sie bei Bedarf nachgelagert anhand einer Anzeigen-ID, die nicht null ist.

Jeder zurückgegebene Anzeigendatensatz kostet 0,5 SocQ-Credits, ohne Grundgebühr. Die Standardschätzung deckt 12 Ergebnisse ab, und ein leeres Ergebnis wird nicht berechnet.