TikTok Trending Feed
Les vidéos de TikTok Trending Feed sont des entrées de fil public exposées pour un contexte régional, avec l’identité de la vidéo et du créateur, les légendes, les images de couverture, les horodatages et l’engagement visible. Ces signaux de contenu et de performance servent à figer la découverte par région, à étudier les créations et à comparer des états à un instant donné.
Fonctionnalités de la TikTok Trending Feed API
- Fil public propre à une régionAccepte une valeur region non vide et collecte le fil vidéo public actuellement exposé pour ce contexte régional de requête.
- Vidéo et créateur normalisésRenvoie dans des enregistrements homogènes les ID et URL sources des vidéos, les légendes, l’identité du créateur, les références d’image de couverture et les horodatages de création et de collecte.
- Indicateurs d’engagement visiblesRéunit pour chaque vidéo renvoyée les nombres publics de vues, de mentions « J’aime », de commentaires, de partages et de favoris.
- Instantané actuel bornéDécoupe la réponse d’un seul fil régional selon results_limit sans suivre la continuation de la source : vous gardez un échantillon du fil actuel, ni classements ni séries historiques.
Paramètres de la TikTok Trending Feed API
| Paramètres | Obligatoire | Description |
|---|---|---|
region | Obligatoire | Valeur de région obligatoire et non vide. Le backend supprime les espaces et la met en majuscules ; utilisez un code de région standard à deux lettres, comme US, pour le contexte régional visé. |
results_limit | Facultatif | Plafond entier facultatif de 4 à 2 000 ; vaut 100 par défaut et s’applique à la réponse unique du fil, qui peut contenir moins de vidéos. |
Comment utiliser la TikTok Trending Feed API
Envoyez une requête de fil régional sous forme de tâche asynchrone, puis lisez les vidéos normalisées grâce à la pagination par curseur des résultats de la tâche.
- Saisissez une valeur region non vide ; utilisez un code standard à deux lettres, comme US, pour le contexte régional visé, et choisissez un results_limit de 4 à 2 000 ou conservez la valeur par défaut de 100.
- Envoyez region et results_limit en POST à /v1/tiktok/trending-feed, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez data.results.items depuis /v1/tasks/{task_id}?limit=50 et poursuivez avec results.next_cursor tant que results.has_more vaut true.
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.Cas d’usage de la TikTok Trending Feed API
- Photographier la découverte d’une région : Stockez ID de vidéos, URL sources, légendes, créateurs et collected_at issus d’une requête de fil régional pour documenter l’ensemble publiquement exposé au moment de la collecte.
- Échantillonner les créations du moment : Examinez légendes, noms de créateurs, images de couverture et dates de création afin de comparer la variété créative visible dans le fil d’une région choisie.
- Comparer l’engagement visible : Rapprochez les nombres de vues, de mentions « J’aime », de commentaires, de partages et de favoris de collected_at pour confronter les signaux d’engagement publics des vidéos renvoyées.
Conseils d’expert pour la TikTok Trending Feed API
- Utilisez un code de région standard à deux lettres, même si le runtime actuel n’exige qu’une valeur non vide ; le backend supprime les espaces et convertit en majuscules.
- Considérez results_limit comme un plafond et non comme un nombre attendu : l’endpoint découpe une seule réponse de fil et ne demande aucune page de continuation à la source.
- Traitez region comme un contexte de disponibilité du fil, pas comme une preuve de l’origine d’une vidéo ; extra.region est une donnée propre à chaque ligne et peut être vide ou différer de la requête.
- N’utilisez les curseurs de résultats de la tâche que pour parcourir les enregistrements déjà sauvegardés par SocQ ; ils ne récupèrent aucune autre page du fil régional.
- Pour comparer des exécutions répétées, dédoublonnez sur l’id de la vidéo et conservez collected_at, car la composition et l’ordre du fil peuvent changer d’une requête à l’autre.
- Traitez les champs du créateur, les métriques, les médias de couverture, les horodatages et les valeurs extra comme nullables, et échappez les légendes publiques avant de les afficher.
API associées
En complément de la TikTok Trending Feed API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques TikTok.
- TikTok Comments API — Collectez les commentaires publics de premier niveau, leurs auteurs, l’engagement, les mentions et les indicateurs d’interaction du créateur.
- TikTok Videos API — Récupérez le créateur, la légende, les médias, la musique, les tags, les mentions et l’engagement à partir d’URL de vidéos.
- TikTok User Videos API — Collectez par nom d’utilisateur les vidéos publiques du fil d’un profil avec légendes, créateurs, médias, horodatages, engagement et contexte du compte source.
- TikTok Video Transcript API — Extrayez le texte de transcription disponible, la langue, le format et le contexte source à partir d’URL de vidéos publiques.
- TikTok Song API — Récupérez les métadonnées d’un son public à partir de l’ID du clip ou de l’URL du morceau.
- TikTok Song Videos API — Collectez les vidéos publiques utilisant des ID de son donnés.
- 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