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.
| Funktion | SocQ | TikTok-Werbeprodukte |
|---|---|---|
| Hauptzweck | Unterstützte öffentliche Anzeigendatensätze suchen und normalisieren | Öffentliche Transparenz oder autorisierte Kampagnenverwaltung, je nach Produkt |
| Eingaben | Ein Werbetreibender oder Stichwort oder eine bekannte Anzeigen-URL | Steuerungen unterscheiden sich je nach betroffenem TikTok-Bereich |
| Private Kampagnendaten | Nicht verfügbar | Erfordert das jeweilige Konto, Produkt, die Freigabe und die Berechtigungen |
| Aktionen | Schreibgeschützter Ablauf mit öffentlichen Daten | Ads Manager unterstützt autorisierte Kampagnenverwaltung |
| Antwortformat | Stabile SocQ-Anzeigendatensätze | Produktspezifische 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. Endpunkt wählen
Senden Sie einen Werbetreibenden oder ein Stichwort an Search oder eine geeignete öffentliche TikTok-Anzeigen-URL an Ad Details.
2. Aufgabe abfragen
Verwenden Sie die zurückgegebene task_id mit /v1/tasks/{task_id}, bis die Verarbeitung erfolgreich ist oder fehlschlägt.
3. Normalisierte Datensätze lesen
Verarbeiten Sie data.results.items und gegebenenfalls einen Cursor des Aufgabenergebnisses; eine Detailanfrage liefert keine oder eine Anzeige.
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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.
YouTube API
Erfassen Sie unterstützte öffentliche YouTube-Kanalprofile, Videodetails, Kanalvideos, Kommentare, Shorts, Stichwort- und Hashtag-Ergebnisse sowie verfügbare Transkripte in einem einheitlichen, normalisierten asynchronen Ablauf.
Facebook API
Erfassen Sie öffentliche Facebook-Seitenprofile, Beiträge, Gruppenbeiträge, Kommentare, per Stichwort gefundene Events und verfügbare Videotranskripte – mit normalisierten Feldern zu Identität, Inhalt, Quelle, Format, Ort, Medien, Reaktionen, Teilnahme und Engagement.
X API
Erfassen Sie öffentliche Profile, Follower- und Gefolgten-Beziehungen, Posts, Antworten, Zitat-Posts, Reposter, Suchergebnisse und aktuelle Trends. Nutzen Sie einheitliche Ergebnisse für Recherche und Monitoring.
LinkedIn API
Rufen Sie öffentliche LinkedIn-Daten zu Profilen, Unternehmen, Beiträgen und Jobs aus bekannten URLs ab – mit normalisierten Feldern zu Identität, Karriere, Unternehmen, Inhalt, Engagement und Jobs.
Reddit API
Rufen Sie öffentliche Reddit-Beiträge und -Kommentare aus bekannten URLs ab, durchsuchen Sie neue, beliebte oder aktuell angesagte Subreddit-Beiträge oder suchen Sie Diskussionen per Stichwort und Veröffentlichungszeitraum.
Pinterest API
Rufen Sie öffentliche Pinterest-Profildaten ab, lösen Sie bekannte Pins auf, erfassen Sie Pins ausgewählter Profile oder suchen Sie per Stichwort – für die Creator-Recherche sowie die Recherche zu Inhalten und visuellen Trends.

