Im TikTok Creative Center sehen Marketer nach, welche Anzeigen am besten laufen, welche Hashtags in einem Land aufsteigen und welche Videos die Charts anführen. Der Creator Marketplace ergänzt Zielgruppendaten und Einstiegspreise von Creators. Am 2026-11-17 hat SocQ sechs Endpunkte hinzugefügt, die diese Daten als JSON liefern. Sie stehen auf der Plattformseite TikTok Creative Center.
Die sechs Endpunkte arbeiten in drei Paaren. Ein Listen-Endpunkt findet Kandidaten, und ein Detail-Endpunkt nimmt die ID aus dieser Liste und liefert die Details. Dieser Leitfaden behandelt jedes Paar: was es zurückgibt, welche Anfrage es erwartet, was es kostet und wann es sich eignet.
Kurze Antwort: Senden Sie einen JSON-Body an
POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>. Speichern Sie die zurückgegebenetask_id, fragen SieGET /v1/tasks/{task_id}ab, bisstatusden Wertsucceededhat, und lesen Sie danndata.results.items.
Die neuen Endpunkte für das TikTok Creative Center
1 SocQ-Credit = $0,005. Listen-Endpunkte rechnen pro Ergebnis ab, ohne Grundgebühr.
| Endpunkt | Rückgabe | Preis |
|---|---|---|
| Top Ads API | Anzeigen mit der besten Leistung, mit Bildunterschrift, Werbetreibendem, Branche, Kampagnenziel, CTR, Likes und Video | 0,5 Credits ($0,0025) pro Anzeige |
| Ad Analysis API | Details einer Anzeige, Impressions-Perzentil sowie sekundengenaue Klick- und Retention-Kurven | 1 Credit ($0,005) pro Aufruf |
| Trending Hashtags API | In einem Land trendende Hashtags mit Rang, Beiträgen, Aufrufen und täglicher Beliebtheitskurve | 0,5 Credits ($0,0025) pro Hashtag |
| Hashtag Insights API | Gesamtwerte eines Hashtags, Beliebtheitskurve, Top-Länder und Beispiel-Video-IDs | 0,5 Credits ($0,0025) pro Aufruf |
| Top Videos API | Top-Video-Chart eines Landes mit Rang, Creator, Chart- und Gesamtaufrufen sowie Interaktionsraten | 0,5 Credits ($0,0025) pro Video |
| Creator Marketplace API | Creator-Karten mit Alters-, Geschlechts-, Länder- und Geräteverteilung der Follower, Median-Aufrufen, Interaktionsrate und Einstiegspreis | 0,5 Credits ($0,0025) pro Creator |
Authentifizierung und der asynchrone Aufgabenablauf
Alle Anfragen authentifizieren sich mit einem API-Schlüssel. Derselbe Header wird für Übermittlung, Aufgabenstatus und Ergebnisabruf verwendet:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Jede Erfassung läuft als Hintergrundaufgabe:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Der Übermittlungsaufruf antwortet sofort mit data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Hat status den Wert succeeded, enthält die Antwort result_count, credits_amount und die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und reicht bis 500. Wenn results.has_more true ist, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. Eine fehlgeschlagene Aufgabe enthält error_message.
Jeder Endpunkt hier akzeptiert außerdem eine optionale callback_url. SocQ sendet nach Abschluss der Aufgabe einen einzelnen POST mit einer Zusammenfassung; die Datensätze lesen Sie über den Aufgaben-Endpunkt. Eine Zeitüberschreitung beim Client bricht eine Aufgabe nicht ab. Setzen Sie daher mit derselben Aufgaben-ID fort, statt erneut zu übermitteln. Ein 402 bedeutet, dass das Konto keine Credits mehr hat, und ein 429, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.
Top Ads und Ad Analysis: Eine Swipe-Datei aufbauen
Die Top Ads API durchsucht die Anzeigen, die das TikTok Creative Center als Top-Performer einstuft. Jede Anzeige enthält Bildunterschrift, Werbetreibenden, Branche, Kampagnenziel, ctr, Likes und das vollständige Video. Alle Felder sind optional: query gleicht Bildunterschriften und Marken ab, time_range ist 7d, 30d (Standard) oder 180d, und sort_by ist relevance (Standard) oder likes. results_limit ist standardmäßig 20 und akzeptiert 1 bis 300. (Doku)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "skincare", "time_range": "30d", "sort_by": "likes"}'
Die Ad Analysis API nimmt die id eines Top-Ads-Ergebnisses als ad_id entgegen. Neben den Details, Ländern und der Landingpage der Anzeige liefert sie impressions_percentile im Vergleich zu ähnlichen Anzeigen, eine click_through_curve und eine retention_curve, jeweils als Wert pro Sekunde Video. Lesen Sie beide Kurven zusammen, um den Hook zu finden, die Stelle, an der Zuschauer abspringen, und den Moment, in dem sie handeln. (Doku)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ad_id": "7697084527089729557"}'
Wann Sie es einsetzen: Creative-Recherche für eine neue Kampagne. Rufen Sie 20 Top-Anzeigen Ihrer Kategorie ab (10 Credits) und analysieren Sie dann die fünf relevantesten (5 Credits). Das sind 15 Credits oder $0,075.
Trending Hashtags und Hashtag Insights: Aufsteigende Tags nach Land erkennen
Die Trending Hashtags API liefert die Hashtags, die in einem Land aufsteigen, jeweils mit Rang, Anzahl der Beiträge, Anzahl der Aufrufe und einer täglichen popularity_curve für den Zeitraum. Alle Felder sind optional: country ist ein zweistelliger Code (Standard US), und time_range ist 7d (Standard), 30d oder 90d. results_limit ist standardmäßig 20 und akzeptiert 1 bis 100. (Doku)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "time_range": "7d", "results_limit": 20}'
Die Hashtag Insights API nimmt eine id aus Trending Hashtags als hashtag_id entgegen, zusammen mit demselben country. Sie liefert Gesamtwerte für Beiträge und Aufrufe, die tägliche Beliebtheitskurve, top_countries mit einem Wert dafür, wie beliebt der Tag im Verhältnis zur Größe jedes Landes ist, sowie video_ids von Beispielvideos. time_range ist standardmäßig 7d. (Doku)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'
Wann Sie es einsetzen: bei der Auswahl von Hashtags für einen Launch in einem bestimmten Markt oder um zu prüfen, ob ein Tag global oder lokal ist, bevor Sie Inhalte darauf aufbauen. Um einen Hashtag zu bewerten, den Sie bereits im Blick haben, auch einen nicht trendenden, liefert die TikTok Hashtag Views API Gesamtvideos und Aufrufe für bis zu 20 Tags auf einmal.
Top Videos und Creator Marketplace: Creators und ihre Preise finden
Die Top Videos API liest das Chart der erfolgreichsten Videos eines Landes aus dem TikTok Creative Center. Jeder Eintrag enthält Rang, Bildunterschrift, Creator, creator_id, Aufrufe im Chart-Zeitraum, organische Aufrufe, Gesamtaufrufe, Interaktionsrate und Sechs-Sekunden-View-Rate. Alle Felder sind optional: country ist standardmäßig US, period ist daily (Standard), weekly oder long_term, und sort_by ist views (Standard), engagement_rate oder six_second_view_rate. Verwendet wird das zuletzt veröffentlichte Chart. results_limit ist standardmäßig 20 und akzeptiert 1 bis 100. (Doku)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "period": "daily", "results_limit": 20}'
Die Creator Marketplace API nimmt 1 bis 20 numerische creator_ids entgegen, etwa die creator_id-Werte aus Top Videos. Jeder Creator mit Karte liefert die Alters-, Geschlechts-, Länder- und Geräteverteilung seiner Follower, Follower-Zahl, Median-Aufrufe, Interaktionsrate, Follower-Wachstumsrate, Sechs-Sekunden-View-Rate, IDs aktueller Videos und den starting_price, den er für ein gesponsertes Video angibt. Berechnet werden nur Creators mit Karte. (Doku)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'
Wann Sie es einsetzen: beim Aufbau einer Creator-Shortlist mit Blick auf das Budget. Ein Tages-Chart mit 20 Videos (10 Credits) und Karten für 20 Creators (10 Credits) kosten 20 Credits oder $0,10.
Wie das zu den anderen TikTok-Endpunkten passt
Die Daten des Creative Centers werden von TikTok aggregiert: Charts, Rankings und Kurven. Für das eigene Profil, die Videos und Kommentare eines Creators nutzen Sie die Endpunkte aus dem Leitfaden zum TikTok-Scraping. Follower-Länder aus dem öffentlichen Konto eines Creators und Prüfungen auf gefälschte Aufrufe finden Sie im Leitfaden zu den neuen TikTok-Endpunkten. Anzeigen auf Meta decken die Facebook Ad Library APIs ab.
FAQ
Brauche ich ein Konto für TikTok Ads oder den Creator Marketplace?
Nein. Sie authentifizieren sich mit einem SocQ-API-Schlüssel und senden die oben gezeigten Felder.
Woher kommt ad_id?
Aus einem Top-Ads-Ergebnis: Übergeben Sie dessen id als ad_id an Ad Analysis. Ebenso geht die id aus Trending Hashtags als hashtag_id an Hashtag Insights, und die creator_id aus Top Videos geht an Creator Marketplace.
Welche Länder kann ich abfragen?
Trending Hashtags, Hashtag Insights und Top Videos nehmen einen zweistelligen country-Code entgegen, etwa US, GB oder JP, mit US als Standard. Verwenden Sie für Hashtag Insights dasselbe country, mit dem Sie den Hashtag gefunden haben.
Ist der Einstiegspreis eines Creators immer vorhanden?
Der Preis ist Teil der Creator-Marketplace-Karte, und nur Creators mit Karte liefern ein Ergebnis. Wie bei anderen SocQ-Feldern wird ein Wert, den die Quelle nicht liefert, als null zurückgegeben.
Wie werden leere Ergebnisse berechnet?
Die Endpunkte mit Abrechnung pro Ergebnis haben keine Grundgebühr, ein Aufruf ohne Ergebnis kostet also nichts. Ad Analysis und Hashtag Insights werden einmal pro Aufruf berechnet.
TIKTOK CREATIVE CENTER API
Workflow mit einer öffentlichen TikTok Creative Center-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
TikTok Creative Center-APIs ansehen