Définition
max_cursor est le paramètre de pagination utilisé par le point de terminaison des publications utilisateur de TikTok, où chaque réponse inclut une valeur max_cursor pour récupérer la page suivante des résultats. Il diffère de la pagination par décalage numérique utilisée par les points de terminaison de recherche et de commentaires.
En profondeur
L'API TikTok utilise trois modèles de pagination distincts, et max_cursor est spécifique au point de terminaison user/posts. Lorsque vous demandez les vidéos d'un utilisateur, la réponse inclut has_more (booléen) et max_cursor (une valeur de type timestamp). Passez max_cursor dans la requête suivante pour obtenir la page suivante. Cela diffère des points de terminaison de recherche et de commentaires qui utilisent des décalages de curseur numériques, et des points de terminaison followers/following qui utilisent page_token+min_time. Le point de terminaison TikTok user/posts de Scavio suit ce modèle : la première requête omet max_cursor, les requêtes suivantes l'incluent depuis la réponse précédente. Chaque page renvoie jusqu'à 20 vidéos pour 1 crédit (0,005 $) par requête.
Exemple d'utilisation
Un chercheur de contenu récupère 100 vidéos récentes du profil d'un créateur. La première requête renvoie 20 vidéos + max_cursor. Quatre requêtes supplémentaires utilisant le max_cursor retourné à chaque fois donne un total de 100 vidéos. Coût : 5 crédits (0,025 $) plus 1 crédit pour la recherche initiale du profil.
Plateformes
Pagination max_cursor sur TikTok est pertinent sur les plateformes suivantes, toutes accessibles via l'API unifiée de Scavio :
- TikTok