Zurück zu den APIs
Transparenz bei TikTok-Werbung

TikTok Ad Library API

Finden Sie unterstützte öffentliche TikTok-Werbedatensätze per Abfrage oder lösen Sie eine bekannte Anzeigen-URL in normalisierte Felder auf – für Recherche, Prüfung und Archivierung.

Verfügbare TikTok-Ad-Library-APIs

Mit Search finden Sie öffentliche Werbedatensätze nach Werbetreibendem oder Stichwort, und mit Ad Details lösen Sie eine bekannte, geeignete öffentliche Anzeigen-URL auf.

Welche Daten zu öffentlicher Werbung können Sie abrufen?

Die zurückgegebenen Felder spiegeln die öffentlichen Informationen wider, die derzeit für jeden unterstützten Datensatz bereitgestellt werden; nicht verfügbare Quellwerte bleiben null oder leer.

Identität von Anzeige und Werbetreibendem

Erfasst öffentliche Anzeigen-IDs, verfügbare Datensatz-URLs, Namen von Werbetreibenden, Verweise auf Werbetreibende und stabile Ressourcentypen.

Creative und Ziel

Prüft verfügbare Anzeigentexte, das Format, Medienverweise und öffentliche URLs der Landingpages.

Sichtbarer Auslieferungskontext

Liest unterstützte Angaben zu Anzeigedaten, Veröffentlichungszeit, Ländern, Plattformen, Zielgruppe und Impressionen, sofern sie bereitgestellt werden.

Erfassungskontext

Bewahrt normalisierte Quell- und Erfassungsfelder für Prüfwarteschlangen, Kataloge und Recherche-Datensätze.

SocQ und TikTok-Werbeprodukte

SocQ bietet die schreibgeschützte Erfassung unterstützter öffentlicher Transparenzdatensätze. Die eigenen Produkte von TikTok dienen unterschiedlichen Zwecken, vom Zugriff auf die öffentliche Bibliothek bis zur autorisierten Kampagnenverwaltung.

FunktionSocQTikTok-Werbeprodukte
HauptzweckUnterstützte öffentliche Anzeigendatensätze suchen und normalisierenÖffentliche Transparenz oder autorisierte Kampagnenverwaltung, je nach Produkt
EingabenEin Werbetreibender oder Stichwort oder eine bekannte Anzeigen-URLSteuerungen unterscheiden sich je nach betroffenem TikTok-Bereich
Private KampagnendatenNicht verfügbarErfordert das jeweilige Konto, Produkt, die Freigabe und die Berechtigungen
AktionenSchreibgeschützter Ablauf mit öffentlichen DatenAds Manager unterstützt autorisierte Kampagnenverwaltung
AntwortformatStabile SocQ-AnzeigendatensätzeProduktspezifische native Ansichten oder Antworten

So funktionieren die TikTok-Ad-Library-APIs

Beide Endpunkte nutzen einen asynchronen Lebenszyklus aus Senden, Abfragen und Lesen; Search kann mehrere Quellseiten erfassen, Ad Details liefert höchstens einen Datensatz.

  1. 1. Endpunkt wählen

    Senden Sie einen Werbetreibenden oder ein Stichwort an Search oder eine geeignete öffentliche TikTok-Anzeigen-URL an Ad Details.

  2. 2. Aufgabe abfragen

    Verwenden Sie die zurückgegebene task_id mit /v1/tasks/{task_id}, bis die Verarbeitung erfolgreich ist oder fehlschlägt.

  3. 3. Normalisierte Datensätze lesen

    Verarbeiten Sie data.results.items und gegebenenfalls einen Cursor des Aufgabenergebnisses; eine Detailanfrage liefert keine oder eine Anzeige.

Mit einer API-Anfrage starten

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel. Search liefert standardmäßig 12 Ergebnisse; Ad Details hat weder Paginierung noch results_limit.

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}'

# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}

Typische Anwendungsfälle der TikTok Ad Library API

Markenbeobachtung

Bauen Sie regelmäßige Prüfmengen verfügbarer öffentlicher Anzeigen auf, die einem bekannten Namen eines Werbetreibenden zugeordnet sind.

Prüfung von Creatives

Lösen Sie ausgewählte Anzeigen auf und prüfen Sie unterstützte öffentliche Felder zu Text, Werbetreibendem, Format, Medien und Ziel.

Transparenzarchivierung

Bewahren Sie normalisierte öffentliche Werbedatensätze mit Anzeigedaten und Erfassungskontext auf.

Anreicherung für die Recherche

Nutzen Sie Suchergebnisse, um Datensätze zu identifizieren, und machen Sie aus bekannten öffentlichen Anzeigen-URLs anschließend stabile Detailfelder.

Grenzen und Richtlinie für öffentliche Daten

Öffentliche Werbedatensätze hängen von der Sichtbarkeit der Quelle, der Eignung, der geografischen Verfügbarkeit, der Veröffentlichungsverzögerung, der Aufbewahrung und den Feldern ab, die der jeweilige TikTok-Bereich bereitstellt.

  • Das Fehlen in der Suche ist kein Beweis dafür, dass ein Werbetreibender nie eine Anzeige geschaltet hat, und nicht verfügbare URLs können ohne Detailergebnis bleiben.
  • Search bietet keine Steuerungen für Land, Datum, Bereich, Sprache, Branche, Ziel, Anreicherung oder Sortierung.
  • Öffentliche Angaben zu Daten, Zielgruppe oder Impressionen ersetzen keine privaten Berichte zu Ausgaben, Conversions, Attribution oder Werbekostenrendite.
  • Medienverweise können temporär oder von der Quelle gesteuert sein, und alle quellabhängigen Felder können null oder leer sein.

Häufige Fragen zur TikTok Ad Library API

Ist SocQ der TikTok Ads Manager?

Nein. SocQ durchsucht und normalisiert unterstützte öffentliche Transparenzdatensätze; es verwaltet weder Konten, Kampagnen, Budgets, Targeting noch Creatives.

Was kann ich senden?

Search akzeptiert einen Namen eines Werbetreibenden oder ein Stichwort. Ad Details akzeptiert eine bekannte, geeignete öffentliche TikTok-Werbe-URL.

Enthält jedes Ergebnis vollständige Anzeigendetails?

Nein. Search liefert häufig Zusammenfassungen, die Detailabfrage kann ohne Datensatz bleiben, und alle quellabhängigen Felder können null oder leer sein.

Wie wird die Nutzung abgerechnet?

Jeder zurückgegebene Datensatz kostet 0,5 SocQ-Credits ohne Grundgebühr; Search liefert standardmäßig 12 Ergebnisse, Ad Details höchstens eines.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.