tiktok-creative-center/
creator-cards

Karten aus dem TikTok Creator Marketplace für bis zu 20 Creator per ID abrufen: Follower nach Alter, Geschlecht, Land und Gerät, Median-Aufrufe, Engagement und Einstiegspreis.

TikTok Creator Marketplace API

Bis zu 20 Creator
Zielgruppen-Demografie
Einstiegspreise
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 Creator Marketplace

Eine Karte im TikTok Creator Marketplace ist das Profil, das Marken sehen, wenn sie einen Creator für bezahlte Zusammenarbeit prüfen: Bio und Follower-Zahl, dazu die Verteilung seiner Follower nach Alter, Geschlecht, Land und Gerät, Median-Aufrufe, Engagement- und Wachstumsraten sowie der Einstiegspreis, den er für ein gesponsertes Video angibt. Mit diesen Karten vergleichen Marken Creator in einer Ansicht nach Zielgruppenpassung, typischer Leistung und Preis.

Funktionen der TikTok Creator Marketplace API

  • Vier Zielgruppen-Schnitteaudience teilt die Follower nach Altersgruppe, Geschlecht, Land und Smartphone-Marke auf, und jeder Eintrag ist ein Anteil von 0 bis 1.
  • Leistungs-Benchmarksmetrics enthält followers_count, median_views, engagement_rate, followers_growth_rate und six_second_view_rate.
  • Angegebener Einstiegspreisstarting_price liefert Betrag und Währung, die der Creator für ein gesponsertes Video angibt, als Zahl, mit der Sie rechnen können.
  • Bis zu 20 Creator pro Anfragecreator_ids nimmt 1 bis 20 Creator-Marketplace-IDs entgegen und liefert für jeden Creator, der eine Karte hat, eine Karte.
  • Identität auf jeder Karteusername, name, Bio-Text, avatar_url, region, tiktok_user_id, url und recent_video_ids ordnen eine Marketplace-ID einem echten Account zu.

Parameter der TikTok Creator Marketplace API

ParameterErforderlichBeschreibung
creator_idsErforderlichEin bis 20 Creator-Marketplace-IDs, etwa creator_id-Werte aus Ergebnissen von TikTok Creative Center Top Videos.

So verwenden Sie die TikTok Creator Marketplace API

Sammeln Sie Creator-IDs aus Top Videos und lesen Sie dann deren Karten aus.

  1. Führen Sie TikTok Creative Center Top Videos aus und kopieren Sie die creator_id der Creator, die Sie prüfen möchten.
  2. Senden Sie {"creator_ids": ["7011198409688219653", "7070293872819044358"]} per POST an /v1/tiktok-creative-center/creator-cards.
  3. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie pro Creator eine Karte aus results.items.
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"]}'

# audience.ages, genders, countries and devices are shares from 0 to 1.

Anwendungsfälle der TikTok Creator Marketplace API

  • Passung der Zielgruppe prüfen: Vergleichen Sie audience.ages, genders und countries einer Shortlist mit der Kundschaft, die Sie erreichen wollen, und streichen Sie Creator, deren Follower in den falschen Märkten sitzen.
  • Kosten pro Aufruf vergleichen: Teilen Sie starting_price.amount durch median_views, um zu vergleichen, was der angegebene Preis jedes Creators einbringt, statt Follower-Zahlen zu vergleichen.
  • Momentum ordnen: Sortieren Sie eine Shortlist nach engagement_rate und followers_growth_rate, um Creator zu finden, die sowohl reaktionsstark sind als auch weiter Follower gewinnen.

Profi-Tipps zur TikTok Creator Marketplace API

  • Nehmen Sie IDs aus dem Feld creator_id der Zeilen von Top Videos; eine TikTok-Nutzer-ID wie author.id passt zu keiner Karte und wird übersprungen.
  • Behandeln Sie jeden Zielgruppen-Schnitt als Liste von Anteilen, die zusammen etwas weniger als 1 ergeben können, und ordnen Sie Einträge über ihr Label zu und nicht über die Position.
  • Lesen Sie starting_price.amount zusammen mit currency und verstehen Sie den Wert als Ausgangspunkt des Creators, denn die endgültigen Preise werden pro Projekt vereinbart.

Ergänzend zur TikTok Creator Marketplace API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok Creative Center-Daten benötigen.

Weitere Plattformen entdecken

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

TikTok Creator Marketplace API — FAQ

TikTok Creator Marketplace API ist eine Schnittstelle zum Abrufen von Karten des TikTok Creator Marketplace für bis zu 20 Creator anhand ihrer Marketplace-IDs. Sie liefert Aufschlüsselungen der Follower nach Alter, Geschlecht, Land und Gerät, Median-Aufrufe, Engagement- und Wachstumsraten, Einstiegspreise und die Identität des Creators.

Die Creator-Marketplace-ID, die in den Zeilen von Top Videos als creator_id zurückkommt und aus 5 bis 32 Ziffern besteht. Eine gewöhnliche TikTok-Nutzer-ID bezeichnet keine Karte, und andere Formate werden mit einem 400-Fehler abgelehnt.

Creator, die dem Creator Marketplace von TikTok beigetreten sind und ein Profil eingerichtet haben; TikTok legt die Berechtigung fest, einschließlich Alters- und Follower-Schwellen, die je nach Projekt variieren. Eine ID ohne Karte wird übersprungen und nicht berechnet, und wenn alle IDs übersprungen werden, schlägt die Aufgabe fehl und die Credits werden erstattet. Jede zurückgegebene Karte kostet 0,5 Credits.

Vier Schnitte der Follower des Creators: Altersgruppen mit Labels wie 18-24 oder 55+, Geschlecht, Land und Smartphone-Marke, jeder Eintrag mit einem Anteil von 0 bis 1. Länder tragen zusätzlich country_code und die Zahl der Follower in der Stichprobe.

starting_price liefert Betrag und Währung, die der Creator als Einstiegspreis für ein gesponsertes Video angibt. Es ist ein Ausgangswert: Creator legen ihre Einstiegspreise selbst fest, und der endgültige Preis wird pro Projekt vereinbart.

Nein, die Abfrage läuft über die Creator-Marketplace-ID. Kandidaten kommen aus TikTok Creative Center Top Videos, wo jede Chart-Zeile eine creator_id trägt.

Nicht von TikTok. Die Abfrage läuft allein über Ihren SocQ-API-Schlüssel, ohne Markenkonto und ohne Partnerfreigabe.