Liefert eine paginierte Liste der Videos eines TikTok-Creators aus der persistierten Datenbank, jeweils mit Veröffentlichungszeit, Caption und Engagement-Zählern. Ideal für Performance-Zeitreihen oder die Auswahl repräsentativer Inhalte.
/api/v1/tiktok/user/videosKontingentverbrauch: Jede erfolgreiche Anfrage an diesen Endpunkt zieht 1 Kontingenteinheiten von Ihrem Plan ab.
Plattformübergreifende Pfadfamilie
/api/v1/{platform}/user/videosVerfügbare Plattformen
Request-Parameter
Pflichtparameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
unique_id | query | string | unique_id example: nike |
Optionale Parameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
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 |
Antwortfelder
| Name | Typ | Beschreibung |
|---|---|---|
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 |
Ausprobieren
Query-Parameter
unique_id*publish_at_startpublish_at_endvideo_idis_paidsort_bysort_orderpagepage_sizecURL-Beispiel
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/user/videos?unique_id=nike" \-H "Authorization: YOUR_API_KEY"
Antwortbeispiel (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}}
Anwendungsfälle
- Content-Performance-Review — Vergleichen Sie das Engagement der neuesten Videos eines Creators, um zu sehen, welche Formate und Themen bei seinem Publikum ankommen.
- Brand-Safety-Prüfung — Prüfen Sie vor einer Partnerschaft aktuelle Captions und Themen, damit die Inhalte des Creators zur Marke passen.