tiktok/
trending-feed

Collectez le fil vidéo TikTok public actuel pour un code de région et obtenez ID de vidéos, légendes, créateurs, images de couverture, horodatages et engagement visible.

TikTok Trending Feed API

Fil régional
Vidéos normalisées
Instantané actuel
0,7 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
regionObligatoireValeur 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_limitFacultatifPlafond 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.

  1. 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.
  2. Envoyez region et results_limit en POST à /v1/tiktok/trending-feed, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  4. 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.

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.

Explorer d’autres plateformes

Combinez les données TikTok avec les données publiques d’autres plateformes sociales prises en charge.

TikTok Trending Feed API — FAQ

TikTok Trending Feed API est une interface programmatique qui collecte le fil vidéo TikTok public actuellement exposé pour une valeur region non vide. Elle renvoie l’identité normalisée des vidéos, les légendes, les créateurs, les images de couverture, les horodatages, l’engagement visible et, lorsqu’ils sont exposés, le contexte de région ou de publicité propre à chaque ligne.

Saisissez une valeur non vide ; le backend supprime les espaces et la convertit en majuscules. Utilisez un code standard à deux lettres, comme US, car la documentation publique et l’interface source définissent ainsi la saisie régionale prévue, même si le runtime actuel n’impose pas ce format à deux lettres.

results_limit vaut 100 par défaut et accepte des entiers de 4 à 2 000. Il découpe la réponse unique du fil régional : une limite plus élevée ne déclenche donc aucune continuation côté source et ne garantit pas autant de vidéos.

Un enregistrement peut contenir l’ID et l’URL source de la vidéo, la légende, l’ID, le nom d’utilisateur et le nom affiché du créateur, les nombres visibles de vues, de mentions « J’aime », de commentaires, de partages et de favoris, une image de couverture, les dates de création et de collecte, ainsi que extra.region et extra.is_ad.

Non. region détermine le contexte de disponibilité du fil pour la requête, pas la localisation du créateur ni l’origine de la vidéo ; extra.region est fourni ligne par ligne et peut être vide ou différent.

Non. Il renvoie les vidéos du fil actuellement exposé, sans rang normalisé, variation de rang, agrégat de hashtags, classement de créateurs, classement de musiques ni séries historiques. Pour comparer, stockez les sorties de tâches répétées avec collected_at.

Chaque vidéo normalisée enregistrée avec succès coûte 0,7 crédit, sans frais de base par tâche. L’estimation initiale se fonde sur results_limit ou sur sa valeur par défaut de 100, et les crédits prélevés d’avance mais non utilisés sont remboursés à la clôture de la tâche.