TikTok Ad Library Ad
TikTok Ad Library Ad löst einen bekannten öffentlichen Werbeeintrag auf, nachdem eine Suche oder die manuelle Prüfung eine passende URL geliefert hat. Daraus wird eine Kennung der Quelle abgeleitet und höchstens eine normalisierte Anzeige zurückgegeben; weder wird ein Werbetreibender durchsucht noch werden Kampagnen aufgelistet oder private Leistungsdaten aus dem Ads Manager offengelegt.
Funktionen der TikTok Ad Library Ad API
- Eingabe einer bekannten Anzeigen-URLSenden Sie eine offizielle TikTok-URL mit http oder https, deren Pfad /ad enthält.
- Ableitung der KennungBevorzugt wird der erste Wert von id in der Query, danach ad_id, danach das ganz rechts stehende numerische Pfadsegment; andernfalls erhält der Anbieter die URL als Ersatz.
- Detailobjekt für eine einzelne AnzeigeFordert ein einzelnes Detailobjekt der Quelle an und gibt höchstens einen Datensatz zurück, und zwar nur, wenn eine unterstützte Anzeigenidentität vorhanden ist.
- Kanonische AnzeigenfelderLiefert stabile Felder zu Werbetreibendem, Text, Datum, Land, Plattform, Format, Ziel, Impressionen, Medien, Veröffentlichung und Erfassung.
- Nullbare Felder nach QuelleNicht verfügbare Werte bleiben null, weil Datensätze der Commercial Content Library und des Creative Center unterschiedliche Felder bereitstellen können.
Parameter der TikTok Ad Library Ad API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Erforderliche einzelne offizielle TikTok-URL mit http oder https, deren Pfad /ad enthält. Bevorzugt wird ein verwendbarer Query-Wert id oder ad_id oder ein numerisches Pfadsegment. |
So verwenden Sie die TikTok Ad Library Ad API
Senden Sie eine bekannte öffentliche Anzeigen-URL, fragen Sie die asynchrone Aufgabe ab und verarbeiten Sie das einzelne Ergebnis, sofern es verfügbar ist.
- Wählen Sie nach Möglichkeit eine offizielle TikTok-Anzeigen-URL mit id, ad_id oder einer numerischen Kennung im Pfad.
- Senden Sie url per POST an /v1/tiktok-ad-library/ad und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe einen Endstatus erreicht.
- Lesen Sie nach einem Erfolg data.results.items; die Detailabfrage liefert null oder ein Element.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; the detail operation returns at most one itemAnwendungsfälle der TikTok Ad Library Ad API
- Prüfung ausgewählter Anzeigen: Lösen Sie eine aus einem Suchergebnis ausgewählte Anzeige in die derzeit verfügbaren normalisierten Detailfelder auf.
- Creative-Prüfung: Untersuchen Sie für eine bekannte Anzeige den öffentlichen Creative-Text, die Identität des Werbetreibenden, Format, Medien und Ziel.
- Transparenzarchiv: Sichern Sie einen öffentlichen Datensatz mit Quell-URL, Anzeigedaten, Auslieferungskontext und Erfassungszeitpunkt.
- Vergleich über Bibliotheken hinweg: Vergleichen Sie unterstützte öffentliche Metadaten ausgewählter Anzeigendatensätze, ohne sie als Kampagnenleistung zu behandeln.
Profi-Tipps zur TikTok Ad Library Ad API
- Bevorzugen Sie URLs mit einem eindeutigen numerischen Query-Wert id oder ad_id, um anbieterabhängiges Ersatzverhalten zu vermeiden.
- Eine gültige URL garantiert nicht, dass die Quelle noch ein identifizierbares Anzeigenobjekt bereitstellt.
- Behandeln Sie Felder der Ads Library und des Creative Center als quellenspezifisch und nicht als direkt austauschbar.
- Archivieren Sie Medien oder Verweise auf Landingpages nur unter geeigneten Bedingungen, denn URLs können ablaufen oder weiterleiten.
- Schließen Sie aus öffentlichen Anzeigedaten oder Impressionen nicht auf Targeting, Ausgaben, Conversions oder Leistung.
- Nutzen Sie den Such-Endpunkt, wenn Sie Anzeigen entdecken möchten; dieser Detail-Endpunkt listet nie die Anzeigen eines Werbetreibenden auf.
Verwandte APIs
Ergänzend zur TikTok Ad Library Ad API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok Ad Library-Daten benötigen.
- TikTok Ad Library Search API — Unterstützte öffentliche TikTok-Werbedatensätze nach einem Werbetreibenden oder Keyword suchen – mit seitenbasiertem Ergebnislimit.