Renvoie une liste paginée des vidéos d'un créateur TikTok depuis la base persistée, avec date de publication, légende et compteurs d'engagement. Idéal pour construire une chronologie de performance ou choisir des contenus représentatifs.
/api/v1/tiktok/user/videosConsommation de quota: Chaque requête réussie vers ce point de terminaison déduit 1 unités de quota de votre forfait.
Famille de chemins multiplateforme
/api/v1/{platform}/user/videosPlateformes disponibles
Paramètres de requête
Paramètres obligatoires
| Nom | Emplacement | Type | Description |
|---|---|---|---|
unique_id | query | string | unique_id example: nike |
Paramètres optionnels
| Nom | Emplacement | Type | Description |
|---|---|---|---|
publish_at_start | query | string | Publish time from example: 2025-01-01 |
publish_at_end | query | string | Publish time to example: 2025-01-31 |
video_id | query | string | Video ID example: 7437208265911455006 |
is_paid | query | string | Sponsored video (1 = yes) example: 1 |
sort_by | query | string | Sort field (publish_at, view_count, engagement_rate) example: publish_at |
sort_order | query | string | Sort direction (asc, desc), default desc example: desc |
page | query | integer | Page number |
page_size | query | integer | Page size |
Champs de réponse
| Nom | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.items | array<object> | Items |
data.total | integer | Total |
data.page | integer | Page |
data.page_size | integer | Page Size |
data.total_pages | integer | Total Pages |
Tester
Paramètres de requête
unique_id*publish_at_startpublish_at_endvideo_idis_paidsort_bysort_orderpagepage_sizeExemple cURL
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/videos?unique_id=nike" \-H "Authorization: YOUR_API_KEY"
Exemple de réponse (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"video_id": "7508413737670413614","description": "Things you might experience on Fly Vini Airlines with captain @Vini Jr.: speed, samba and smiles. #NikeFootball ","video_url": "https://www.tiktok.com/@nike/video/7508413737670413614","cover_url": "https://img.scrumball.cn/tiktok/FuaboiN2W8mT6WnSCI9Qs1Ywo9LE?imageView2/2/w/300","duration_second": 32,"tags": ["nikefootball"],"publish_at": "2025-05-26 00:00:39","view_count": 188037,"share_count": 293,"like_count": 8058,"comment_count": 162,"like_rate": "0.04","view_follower_rate": "0.03","engagement_rate": "4.53","video_author_nickname": "Nike","video_author_unique_id": "nike","video_author_url": "https://www.tiktok.com/@nike","video_author_follower_count": 7393587,"last_update_at": "2025-06-06 15:43:28"}],"total": 704,"page": 1,"page_size": 1,"total_pages": 704}}
Cas d'usage
- Bilan de performance des contenus — Comparez l'engagement des dernières vidéos d'un créateur pour repérer les formats et sujets qui plaisent à son audience.
- Contrôle de brand safety — Passez en revue les légendes et thèmes récents avant un partenariat pour vérifier l'adéquation avec la marque.