Skip to main content
GET
/
v1
/
tiktok
/
videos
/
{video_id}
Get Video Detail
curl --request GET \
  --url https://scrapebadger.com/v1/tiktok/videos/{video_id} \
  --header 'x-api-key: <api-key>'
{
  "video": {
    "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
  },
  "region": "US"
}
Pass the author’s username to skip the internal oEmbed author lookup for a faster, cheaper fetch.
Each request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Path Parameters

video_id
string
required

The numeric TikTok video/aweme id.

Query Parameters

region
string
default:US

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

username
string

Author @handle. When supplied, skips the oEmbed author lookup for a faster, cheaper fetch.

Response

200 - application/json

Video detail

video
object
required

A TikTok post (video or photo slideshow) with full metadata.

region
string
required