ToolzerHub Docs

List account videos (v3)

List an account's videos with captions, counts, cover, sound and hashtags. Pinned videos come first, then newest first. Paginate with cursor and has_more. An unknown account returns data: null or an empty page.

1 credit / requestBilled only on success
GET
/v3/tiktok/user/videos

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

sec_uid*string

Account sec_uid, from /v3/tiktok/user or the author of any video.

Match^[A-Za-z0-9_-]{20,200}$
count?integer

Items to request per page, 1 to 50. A page can hold fewer.

Range1 <= value <= 50
Default30
cursor?string

cursor from the previous response. Omit for the first page and send it unchanged for later pages.

Match^\d{1,20}$
curl -X GET "https://example.com/v3/tiktok/user/videos?sec_uid=MS4wLjABAAAAU9BRVzC8oCaegVnia8IbqWhPb_-dbU7s00Y3wS1_Nx8g5RUaYvyXrpejgjdxTwd6" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "items": [      {        "id": "7665075736742530317",        "url": "https://www.tiktok.com/@nasa/video/7665075736742530317",        "description": "Something big just landed on TikTok.",        "created_at": "2026-07-21T20:09:02.000Z",        "author": {          "id": "7664638705177150477",          "sec_uid": "MS4wLjABAAAAU9BRVzC8oCaegVnia8IbqWhPb_-dbU7s00Y3wS1_Nx8g5RUaYvyXrpejgjdxTwd6",          "username": "nasa",          "nickname": "NASA",          "avatar": "https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=6ac071bf&x-expires=1792249200&x-signature=glSVE16gomtzFt8L3U0mUwIKTAw%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=132edbea&idc=no1a&sc=avatar&s=PUBLISH",          "verified": true        },        "stats": {          "plays": 1614926,          "likes": 104493,          "comments": 3051,          "shares": 3268,          "saves": 7591        },        "video": {          "duration": 25.169,          "cover": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/oAUhkWfCZC7g6ALj2HZgOeELFvIrALeFYOoGI4~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=9232&refresh_token=cf084f0b&x-expires=1792249200&x-signature=reyA0kUyEI69Mei0%2BSAFsyA0W8k%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",          "width": 720,          "height": 1280        },        "music": {          "id": "7665075815390645006",          "title": "original sound - nasa",          "author": "NASA"        },        "hashtags": []      },      {        "id": "7694341613870501150",        "url": "https://www.tiktok.com/@google/video/7694341613870501150",        "description": "You’d need to line up 100 million Moons just to stretch across the black hole TON 618 🤯 Get more mind-blowing space facts with @Google Search  #SpaceWeek #SpaceFacts ",        "created_at": "2026-10-08T16:55:43.000Z",        "author": {          "id": "6949137531950842886",          "sec_uid": "MS4wLjABAAAABqImMisT8O3jtr2Ufg4t7wTYypL4gPC9rWRrIkkThwCgCVMRJW6ls-n2T6bmDMZb",          "username": "google",          "nickname": "Google",          "avatar": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/4ef0c27fa949cb7595b0b195d45f8f13~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&refresh_token=3b702d06&x-expires=1792249200&x-signature=azhXBxURwAAI0cdsKcSp%2Fqo1ArQ%3D&t=223449c4&ps=87d6e48a&shp=d05b14bd&shcp=132edbea&idc=no1a&sc=avatar&s=PUBLISH",          "verified": true        },        "stats": {          "plays": 148503,          "likes": 11206,          "comments": 272,          "shares": 531,          "saves": 1255        },        "video": {          "duration": 19.552,          "cover": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oQECHi1tfBAZivBhIPudAKAAi4yABY5CoDLAIw~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=9232&refresh_token=23e48ecc&x-expires=1792249200&x-signature=xbUfAKsfVaw7M1n2prBqo%2F2QTEk%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=132edbea&idc=no1a&biz_tag=tt_video&s=PUBLISH&sc=cover",          "width": 720,          "height": 1280        },        "music": {          "id": "7694341736717355807",          "title": "original sound - google",          "author": "Google"        },        "hashtags": [          "spaceweek",          "spacefacts"        ]      }    ],    "count": 2,    "cursor": "1787074754293",    "has_more": true  }}