Skip to main content
GET
/
v1
/
tiktok
/
users
/
{username}
/
videos
Get User Videos
curl --request GET \
  --url https://scrapebadger.com/v1/tiktok/users/{username}/videos \
  --header 'x-api-key: <api-key>'
{
  "videos": [
    {
      "id": "7234567890123456789",
      "description": "new dance #fyp #dance",
      "create_time_utc": 1700000000,
      "create_time_at": "2023-11-14T22:13:20Z",
      "region": "US",
      "url": "https://www.tiktok.com/@charlidamelio/video/7234567890123456789",
      "share_url": "https://www.tiktok.com/@charlidamelio/video/7234567890123456789",
      "aweme_type": 0,
      "author": {
        "id": "6784129854561813509",
        "sec_uid": "MS4wLjABAAAA...",
        "unique_id": "charlidamelio",
        "nickname": "charli d'amelio",
        "avatar_thumb": "https://p16-sign.tiktokcdn-us.com/avatar.jpeg",
        "signature": "no bio yet",
        "verified": true,
        "follower_count": 155600000,
        "following_count": 1300,
        "heart_count": 11800000000,
        "video_count": 2700,
        "region": "US"
      },
      "music": {
        "id": "7011111111111111111",
        "title": "original sound",
        "author_name": "charli d'amelio",
        "duration": 15,
        "play_url": "https://sf16-sg.tiktokcdn.com/music.mp3",
        "original": true
      },
      "stats": {
        "play_count": 24000000,
        "digg_count": 3100000,
        "comment_count": 18000,
        "share_count": 42000,
        "collect_count": 99000
      },
      "video": {
        "height": 1024,
        "width": 576,
        "duration": 15,
        "ratio": "540p",
        "format": "mp4",
        "cover": "https://p16-sign.tiktokcdn-us.com/cover.jpeg",
        "play_addr": "https://v16-webapp.tiktok.com/video.mp4",
        "download_addr": "https://v16-webapp.tiktok.com/download.mp4",
        "has_watermark": true
      },
      "hashtags": [
        "fyp",
        "dance"
      ],
      "mentions": [],
      "challenges": [
        {
          "id": "229207",
          "title": "fyp",
          "desc": "",
          "is_commerce": false
        }
      ],
      "is_slideshow": false,
      "image_urls": [],
      "is_ad": false,
      "is_pinned": false
    }
  ],
  "pagination": {
    "has_more": true,
    "cursor": "30",
    "count": 30,
    "search_id": null
  },
  "region": "US"
}
Each request costs 8 credits. Failed requests are not charged.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
username
string
required

The user's @handle (unique_id), without the leading '@'.

Query Parameters

​
region
string
default:US

Content region (ISO 3166-1 alpha-2). Routes the request through a proxy and signer for that locale.

​
count
integer
default:30

Maximum number of items to return (1-50).

Required range: 1 <= x <= 50
​
cursor
string

Pagination cursor — pass the pagination.cursor value from a prior response to fetch the next page. Omit for the first page.

Response

200 - application/json

User videos

​
region
string
required
​
videos
object[]
​
pagination
object

Cursor pagination metadata shared by all list endpoints.