tiktok/
trending-feed

Rufen Sie den aktuellen öffentlichen TikTok-Video-Feed zu einem Regionscode ab – mit Video-IDs, Bildunterschriften, Creators, Titelbildern, Zeitstempeln und sichtbarer Interaktion.

TikTok Trending Feed API

Regionaler Feed
Normalisierte Videos
Aktuelle Momentaufnahme
0,7 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

TikTok Trending Feed

Videos des TikTok Trending Feed sind öffentliche Feed-Einträge, die für einen regionalen Kontext bereitgestellt werden, mit Video- und Creator-Identität, Bildunterschriften, Titelbildern, Zeitstempeln und sichtbarer Interaktion. Diese Inhalts- und Leistungssignale eignen sich für regionale Momentaufnahmen der Entdeckung, für Creative-Recherche und für Vergleiche zu bestimmten Zeitpunkten.

Funktionen der TikTok Trending Feed API

  • Öffentlicher Feed einer RegionAkzeptiert einen nicht leeren Wert für region und erfasst den aktuellen öffentlichen Video-Feed, der für diesen regionalen Anfragekontext bereitgestellt wird.
  • Normalisierte Video- und Creator-DetailsLiefert Video-IDs und Quell-URLs, Bildunterschriften, Creator-Identität, Verweise auf Titelbilder sowie Zeitstempel für Erstellung und Erfassung in einheitlichen Datensätzen.
  • Sichtbare InteraktionskennzahlenHält die öffentlichen Zahlen zu Aufrufen, Likes, Kommentaren, Shares und Speicherungen für jedes zurückgegebene Video zusammen.
  • Begrenzte aktuelle MomentaufnahmeKürzt eine einzelne regionale Feed-Antwort auf results_limit, ohne der Fortsetzung der Quelle zu folgen, und liefert eine aktuelle Stichprobe des Feeds statt Platzierungen oder historischer Reihen.

Parameter der TikTok Trending Feed API

ParameterErforderlichBeschreibung
regionErforderlichErforderlicher, nicht leerer Regionswert. Das Backend entfernt umgebende Leerzeichen und wandelt ihn in Großbuchstaben um; verwenden Sie für den gewünschten regionalen Kontext einen üblichen zweibuchstabigen Regionscode wie US.
results_limitOptionalOptionale Obergrenze als ganze Zahl von 4 bis 2.000; Standard ist 100. Sie kürzt die einzelne Feed-Antwort, die auch weniger Videos enthalten kann.

So verwenden Sie die TikTok Trending Feed API

Senden Sie eine Anfrage für einen regionalen Feed als asynchrone Aufgabe und lesen Sie die normalisierten Videos anschließend per Cursor-Paginierung des Aufgabenergebnisses aus.

  1. Geben Sie einen nicht leeren Wert für region ein; verwenden Sie für den gewünschten regionalen Kontext einen üblichen zweibuchstabigen Code wie US und wählen Sie ein results_limit von 4 bis 2.000 oder behalten Sie den Standardwert 100.
  2. Senden Sie region und results_limit per POST an /v1/tiktok/trending-feed und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  4. Lesen Sie data.results.items aus /v1/tasks/{task_id}?limit=50 und fahren Sie mit results.next_cursor fort, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/tiktok/trending-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"US","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Anwendungsfälle der TikTok Trending Feed API

  • Eine regionale Momentaufnahme der Entdeckung festhalten: Speichern Sie Video-IDs, Quell-URLs, Bildunterschriften, Creators und collected_at aus einer regionalen Feed-Anfrage, um die öffentlich bereitgestellte Auswahl zum Zeitpunkt der Erfassung zu dokumentieren.
  • Aktuelle Creative-Muster stichprobenartig prüfen: Sehen Sie Bildunterschriften, Creator-Namen, Titelbilder und Erstellungszeiten durch, um den sichtbaren Creative-Mix in einem ausgewählten regionalen Feed zu vergleichen.
  • Sichtbare Interaktion vergleichen: Nutzen Sie die Zahlen zu Aufrufen, Likes, Kommentaren, Shares und Speicherungen zusammen mit collected_at, um öffentliche Interaktionssignale der zurückgegebenen Videos zu vergleichen.

Profi-Tipps zur TikTok Trending Feed API

  • Verwenden Sie einen üblichen zweibuchstabigen Regionscode, auch wenn die aktuelle Laufzeit nur einen nicht leeren Wert verlangt; das Backend entfernt Leerzeichen und wandelt den Wert in Großbuchstaben um.
  • Verstehen Sie results_limit als Obergrenze und nicht als erwartete Anzahl, denn der Endpunkt kürzt eine einzelne Feed-Antwort und fordert keine Fortsetzungsseiten der Quelle an.
  • Behandeln Sie region als Kontext der Feed-Verfügbarkeit und nicht als Beleg für die Herkunft eines Videos; extra.region ist ein Wert auf Zeilenebene und kann leer sein oder von der Anfrage abweichen.
  • Nutzen Sie Cursor der Aufgabenergebnisse nur, um Datensätze zu blättern, die SocQ bereits gespeichert hat; sie rufen keine weitere Seite aus dem regionalen Feed ab.
  • Entfernen Sie beim Vergleich wiederholter Abrufe Duplikate anhand der Video-id und behalten Sie collected_at, da sich Zusammensetzung und Reihenfolge des Feeds zwischen Anfragen ändern können.
  • Behandeln Sie Creator-Felder, Kennzahlen, Titelbilder, Zeitstempel und extra-Werte als nullable und maskieren Sie öffentliche Bildunterschriften, bevor Sie sie anzeigen.

Ergänzend zur TikTok Trending Feed API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher TikTok-Daten benötigen.

  • TikTok Comments API — Öffentliche Kommentare der obersten Ebene, Autoren, Interaktionen, Erwähnungen und Merkmale zur Creator-Interaktion erfassen.
  • TikTok Videos API — Creator, Bildunterschrift, Medien, Musik, Tags, Erwähnungen und Interaktionen aus Video-URLs abrufen.
  • TikTok User Videos API — Öffentliche Videos aus dem Profil-Feed per Benutzername erfassen – mit Bildunterschriften, Creators, Medien, Zeitstempeln, Interaktionen und Kontext des Quellkontos.
  • TikTok Video Transcript API — Verfügbaren Transkripttext, Sprache, Format und Quellkontext aus öffentlichen Video-URLs extrahieren.
  • TikTok Song API — Öffentliche Sound-Metadaten per Clip-ID oder Musik-URL abrufen.
  • TikTok Song Videos API — Öffentliche Videos zu angegebenen Sound-IDs erfassen.

Weitere Plattformen entdecken

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

TikTok Trending Feed API — FAQ

TikTok Trending Feed API ist eine Schnittstelle zum Erfassen des aktuellen öffentlichen TikTok-Video-Feeds, der für einen nicht leeren Wert region bereitgestellt wird. Sie liefert normalisierte Video-Identität, Bildunterschriften, Creators, Titelbilder, Zeitstempel, sichtbare Interaktion und, sofern bereitgestellt, Region oder Werbekontext auf Zeilenebene.

Übergeben Sie einen nicht leeren Wert für region; das Backend entfernt umgebende Leerzeichen und wandelt ihn in Großbuchstaben um. Verwenden Sie einen üblichen zweibuchstabigen Code wie US, weil die öffentliche Dokumentation und die Quellschnittstelle die vorgesehene regionale Eingabe so definieren, auch wenn die aktuelle Laufzeit das zweibuchstabige Format nicht erzwingt.

results_limit ist standardmäßig 100 und akzeptiert ganze Zahlen von 4 bis 2.000. Es kürzt eine einzelne zurückgegebene regionale Feed-Antwort, sodass ein höheres Limit keine Fortsetzung der Quelle auslöst und nicht garantiert, dass so viele Videos vorliegen.

Ein Datensatz kann Video-ID und Quell-URL, Bildunterschrift, Creator-ID, Benutzernamen und Anzeigenamen, die sichtbaren Zahlen zu Aufrufen, Likes, Kommentaren, Shares und Speicherungen, ein Titelbild, Erstellungs- und Erfassungszeit sowie extra.region und extra.is_ad enthalten.

Nein. region steuert den Kontext der Feed-Verfügbarkeit für die Anfrage, nicht den Standort des Creators oder die Herkunft des Videos; extra.region wird pro Zeile geliefert und kann leer sein oder abweichen.

Nein. Er liefert Videos des aktuell bereitgestellten Feeds ohne normalisierte Felder für Platzierung, Platzierungsänderung, Hashtag-Aggregate, Creator-Charts, Song-Charts oder historische Reihen. Vergleiche entstehen, indem Sie die Ausgaben wiederholter Aufgaben mit collected_at speichern.

Jedes erfolgreich gespeicherte normalisierte Video kostet 0,7 Credits, ohne Grundgebühr pro Aufgabe. Die erste Schätzung verwendet results_limit oder den Standardwert 100, und nicht verbrauchte vorab abgebuchte Credits werden erstattet, wenn die Aufgabe abgerechnet wird.