Lister les publications d'un compte TikTok via l'API
L'API for Business de TikTok liste les publications publiques d'un compte avec GET /business/video/list/, de la plus récente à la plus ancienne, jusqu'à 20 par page. Indiquez les champs à renvoyer, comme item_id, caption, share_url et video_views, et parcourez les pages avec cursor tant que has_more vaut true. filters.video_ids isole certaines publications, et chaque item_id est l'ID attendu par les appels de commentaires.
easyCoexistence liste les publications récentes d'un compte TikTok avec list_social_posts depuis Claude, ChatGPT ou votre propre code, avec pour chacune son item_id, sa légende, son lien et ses compteurs, et get_social_credentials donne à votre propre code le token pour les pages suivantes et les autres champs.
Le maximum de publications que /business/video/list/ renvoie par page ; max_count vaut 10 par défaut.
Unité du curseur : un horodatage Unix UTC ; l'endpoint renvoie les publications publiées avant lui.
Le champ par défaut, que doit inclure toute requête nommant plusieurs champs, sinon une erreur peut survenir.
Nombre d'appels autorisés par compte autorisé sur cet endpoint, comme sur chaque endpoint de l'Accounts API.
Que renvoie l'endpoint ?
Les publications publiques du compte : vidéos affichées sur son profil, publications photo et texte, et vidéos Only show in ads, qui diffusent des publicités sans apparaître sur le profil. media_type distingue VIDEO de PHOTO, qui couvre les publications photo et texte. Les publications que TikTok a filtrées pour infraction, comme pour des droits musicaux, ne figurent pas dans la liste.
Comment l'appeler ?
Avec un GET et des paramètres d'URL : business_id, fields sous forme de tableau JSON, et facultativement filters, cursor et max_count, qui vaut 10 par défaut. Le token va dans l'en-tête Access-Token, et l'application développeur a besoin de la permission Get Account Media sous TikTok Accounts :
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/video/list/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["item_id","create_time","media_type","caption","share_url","thumbnail_url","video_views","likes","comments","shares"]' \
--data-urlencode 'max_count=20'Quels champs décrivent une publication ?
Outre les métriques, qui vont de video_views à impression_sources, la liste comprend ces champs, tous sous le scope video.list :
item_id: l'ID de la publication, utilisé par les appels de commentaires et par filters.video_ids.media_type: VIDEO, ou PHOTO pour une publication photo ou texte.is_ad: indique si la publication est utilisée dans une publicité.create_time: la date de publication, en secondes Unix UTC.- caption : la description de la publication, hashtags compris.
share_url: un lien partageable, qui se comporte différemment sur mobile et sur ordinateur.embed_url: un lien de lecteur pour d'autres sites, qui ne permet pas de lire les publications réglées sur Amis ou Seulement moi.thumbnail_url: une image d'aperçu temporaire dont l'expiration figure dans son paramètre x-expires.video_duration: la durée en secondes, à trois décimales.
À quoi ressemble une page de résultats ?
Un tableau videos dans l'ordre renvoyé par TikTok, plus cursor, la valeur à envoyer pour la page suivante, et has_more, qui indique s'il en existe une. create_time arrive sous forme de chaîne de secondes Unix. Exemple de TikTok, réduit aux champs descriptifs et aux compteurs :
{
"code": 0,
"message": "OK",
"request_id": "2021080307532501024502410704A7306F",
"data": {
"videos": [
{
"item_id": "6990565363377392901",
"create_time": "1627617835",
"caption": "little coco",
"share_url": "https://www.tiktok.com/@feather_in_the_w1nd/video/6990565363377392901?utm_campaign=tt4d_open_api&utm_source=6979330045630218242",
"likes": 10,
"comments": 2,
"shares": 0,
"video_views": 1231
}
],
"cursor": 0,
"has_more": false
}
}Comment fonctionne la pagination ?
Par le temps. cursor vaut par défaut l'instant présent en millisecondes, de sorte que la première page contient les publications les plus récentes, et chaque réponse renvoie le curseur de la requête suivante. Transmettez-le tant que has_more vaut true. Un horodatage personnalisé liste les publications publiées avant ce moment, et les règles de confiance et de sécurité de TikTok peuvent faire descendre une page sous max_count alors que d'autres publications existent encore.
import json, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
def all_posts(token: str, business_id: str, fields: list[str]):
params = {"business_id": business_id, "fields": json.dumps(fields), "max_count": 20}
while True:
r = requests.get(f"{API}/business/video/list/", headers={"Access-Token": token},
params=params, timeout=30).json()
if r["code"] != 0:
raise RuntimeError(f"{r['code']}: {r['message']}")
yield from r["data"].get("videos", [])
if not r["data"].get("has_more"):
return
params["cursor"] = r["data"]["cursor"]Comment récupérer des publications précises ?
Avec filters, un objet JSON : video_ids liste les ID de publications à renvoyer, comme les post_ids d'un statut de publication. ad_post_only, valable uniquement avec video_ids, ne garde que les publications autorisées aux annonceurs pour les Spark Ads. Une requête filtrée prend les mêmes champs que n'importe quelle autre, si bien qu'un seul appel peut renvoyer les derniers chiffres de quelques publications connues.
filters={"video_ids":["6995316737801538821","8015388216995316737"]}Quelles limites s'appliquent ?
L'Accounts API autorise 40 appels par minute pour chaque compte autorisé sur cet endpoint, et les appels à l'Accounts API d'une application sont plafonnés ensemble à 600 par minute au niveau Basic et à 1 000 au-delà. Les champs descriptifs sont en temps réel, les compteurs accusent généralement 24 à 48 heures de retard, et les données d'une publication cessent d'être mises à jour 365 jours après sa publication.
Comment easyCoexistence liste les vidéos ?
Avec list_social_posts, qui prend account_id et une limite facultative, de 1 à 20 pour TikTok. Il renvoie la première page de TikTok : les publications les plus récentes avec item_id, create_time, caption, share_url, thumbnail_url, video_views, likes, comments et shares, ainsi que cursor et has_more. Les pages suivantes et les autres champs viennent de votre propre code, avec le token et le business_id de get_social_credentials :
GET https://business-api.tiktok.com/open_api/v1.3/business/video/list/
?business_id=<BUSINESS_ID>
&fields=["item_id","media_type","caption","embed_url"]
&cursor=1793404800000
&max_count=20
Access-Token: <ACCESS_TOKEN>Erreurs courantes
- Demander des champs sans item_id. La référence de TikTok avertit qu'une requête nommant plusieurs champs sans lui peut échouer.
- S'arrêter quand une page revient incomplète. TikTok peut renvoyer moins de max_count publications alors que has_more vaut toujours true : suivez donc has_more.
- Conserver thumbnail_url pour plus tard. C'est un lien temporaire qui expire à l'heure figurant dans son paramètre x-expires : demandez-en un nouveau quand vous en avez besoin.
- Chercher des publications privées dans la liste. L'endpoint ne renvoie que des publications publiques.
De US$ 9 à US$ 0,75 par connexion et par mois, qui baisse à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Combien de vidéos TikTok l'API peut-elle lister à la fois ?
Jusqu'à 20 par page avec /business/video/list/. max_count fixe la taille de page et vaut 10 par défaut ; suivez cursor pour en obtenir davantage.
L'API TikTok liste-t-elle aussi les publications photo ?
Oui. /business/video/list/ renvoie les publications vidéo, photo et texte publiques, et media_type distingue VIDEO de PHOTO.
La liste des vidéos TikTok inclut-elle les publications réservées aux publicités ?
Oui. /business/video/list/ renvoie aussi les vidéos Only show in ads, qui diffusent des publicités sans apparaître sur le profil, et is_ad indique si une publication est utilisée dans une publicité.
Pourquoi une publication TikTok manque-t-elle dans la liste de l'API ?
L'endpoint liste les publications publiques, et TikTok écarte les publications filtrées pour infraction, comme pour des droits musicaux.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le