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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
region | Erforderlich | Erforderlicher, 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_limit | Optional | Optionale 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.
- 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.
- Senden Sie region und results_limit per POST an /v1/tiktok/trending-feed und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- 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.
Verwandte APIs
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.
- TikTok Profiles API
- TikTok Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API