Get video or photo carousel detail & 1080p no-watermark URL

GET/v1/video/detail10 Credits / request($1.00 / 1K requests)

Fetch full metadata, engagement metrics, creator profile, music track, image carousel slides, and direct 1080p HD no-watermark download links (data.play, data.hdplay) for any public TikTok video.

Query Parameters

urlstringrequired
TikTok video URL, short link (vm.tiktok.com), or numeric video ID.
Example: https://www.tiktok.com/@tiktok/video/7106594312292453675
hdinteger
Set to 1 to include the 1080p HD no-watermark stream URL in data.hdplay.
Example: 1

Example Request (cURL / Python / JavaScript)

curl "https://api.shortvidapi.com/v1/video/detail?url=https%3A%2F%2Fwww.tiktok.com%2F%40tiktok%2Fvideo%2F7106594312292453675" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://shortvidapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "aweme_id": "v12044gd0000cafr3i3c77u2codsenc0",
    "id": "7106594312292453675",
    "region": "US",
    "title": "how many frogs did you find? 🐸 check out tiktok’s #Minecraft community today! @Gorillo",
    "content_desc": [],
    "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/beee36ba02ef449397b2d128bc32dd9d_1654632931~tplv-tiktokx-cropcenter-q:300:400:q70.jpeg?dr=8596&refresh_token=194dd834&x-expires=1793631600&x-signature=tYoecY...",
    "ai_dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/07edb7fb43d0469da286ffa8e6a10cf3_1654632930~tplv-tiktokx-origin.image?dr=8606&refresh_token=4cb0d3cf&x-expires=1793631600&x-signature=yl1Dv6EwScCKMI22i4QLo2Q...",
    "origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/bc4fdc1d910a483489b02822d6b9c2b9_1654632930~tplv-tiktokx-shrink-aq:360:360:q75.webp?dr=11731&refresh_token=71686917&x-expires=1793631600&x-signature=J8HS0fPy...",
    "duration": 24,
    "play": "https://v19.tiktokcdn-us.com/b8d2c59d91ad53c28951f11295dd39d3/6ae7ab49/video/tos/useast5/tos-useast5-ve-0068c003-tx/290d9614206e4076b11579a437577a48/?a=1233&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=1046&ft=kLx3-yt4ZZo0PD...",
    "wmplay": "https://v19.tiktokcdn-us.com/52a6f89570c9447f68132c66c2465b8e/6ae7ab49/video/tos/useast5/tos-useast5-pve-0068-tx/ba0aec3465404e68a34b59f36151646a/?a=1233&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=1052&ft=kLx3-yt4ZZo0PD8sT...",
    "hdplay": "https://v16.tokcdn.com/d3cd537d7e90ed1b65f70115793d31e9/629e9500/7106594312292453675_original.mp4",
    "size": 3288875,
    "wm_size": 3308379,
    "hd_size": 30294767,
    "music": "https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150eab7cfe73b1c4/6af09181/video/tos/useast5/tos-useast5-v-27dcd7-tx/400ba31d967e4a48b0378f52036accc7/?a=583965&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=125&ft=kJxKSy...",
    "music_info": {
      "id": "7106594280055130923",
      "title": "original sound - tiktok",
      "play": "https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150eab7cfe73b1c4/6af09181/video/tos/useast5/tos-useast5-v-27dcd7-tx/400ba31d967e4a48b0378f52036accc7/?a=583965&bti=OTg7QGo5QHM6OjZALTAzYCMvcCMxNDNg&&bt=125&ft=kJxKSy...",
      "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:1080:1080:q70.jpeg?dr=8837&refresh_token=28baf0a5&x-expires=1793631600&x-signature=Nshe2H%2Fw9c5...",
      "author": "TikTok",
      "original": true,
      "duration": 24,
      "album": "",
      "create_time": 1654632935
    },
    "play_count": 592612,
    "digg_count": 98933,
    "comment_count": 1269,
    "share_count": 361,
    "download_count": 130,
    "collect_count": 59275,
    "create_time": 1654632929,
    "anchors": null,
    "anchors_extras": "",
    "is_ad": false,
    "commerce_info": {
      "adv_promotable": false,
      "auction_ad_invited": false,
      "branded_content_type": 0,
      "is_diversion_ad": 0,
      "organic_log_extra": "{\"req_id\":\"2026110115121604C3A0C50D7B6EC231A5\"}",
      "with_comment_filter_words": false
    },
    "commercial_video_info": "",
    "item_comment_settings": 0,
    "mentioned_users": "6821528796420703237",
    "author": {
      "id": "107955",
      "unique_id": "tiktok",
      "nickname": "TikTok",
      "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:300:300:q70.jpeg?dr=8834&refresh_token=e0b527e0&x-expires=1793631600&x-signature=VHKavV3PAEmdRSq..."
    },
    "is_nff_or_nr": false
  }
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://shortvidapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`aweme_id`	string	Example: v12044gd0000cafr3i3c77u2codsenc0
`id`	string	Example: 7106594312292453675
`region`	string	Example: US
`title`	string	Example: how many frogs did you find? 🐸 check out tiktok’s #Minecraf
`content_desc`	array of string
`cover`	string	Example: https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-
`ai_dynamic_cover`	string	Example: https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-
`origin_cover`	string	Example: https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-
`duration`	integer	Example: 24
`play`	string	Example: https://v19.tiktokcdn-us.com/b8d2c59d91ad53c28951f11295dd39d
`wmplay`	string	Example: https://v19.tiktokcdn-us.com/52a6f89570c9447f68132c66c2465b8
`hdplay`	string	Example: https://v16.tokcdn.com/d3cd537d7e90ed1b65f70115793d31e9/629e
`size`	integer	Example: 3288875
`wm_size`	integer	Example: 3308379
`hd_size`	integer	Example: 30294767
`music`	string	Example: https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150ea
`music_info`	object
`id`	string	Example: 7106594280055130923
`title`	string	Example: original sound - tiktok
`play`	string	Example: https://v16-ies-music.tiktokcdn-us.com/905cab1b42fc5525150ea
`cover`	string	Example: https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-006
`author`	string	Example: TikTok
`original`	boolean	Example: true
`duration`	integer	Example: 24
`album`	string	Example:
`create_time`	integer	Example: 1654632935
`play_count`	integer	Example: 592612
`digg_count`	integer	Example: 98933
`comment_count`	integer	Example: 1269
`share_count`	integer	Example: 361
`download_count`	integer	Example: 130
`collect_count`	integer	Example: 59275
`create_time`	integer	Example: 1654632929
`anchors`	string
`anchors_extras`	string	Example:
`is_ad`	boolean	Example: false
`commerce_info`	object
`adv_promotable`	boolean	Example: false
`auction_ad_invited`	boolean	Example: false
`branded_content_type`	integer	Example: 0
`is_diversion_ad`	integer	Example: 0
`organic_log_extra`	string	Example: {"req_id":"2026110115121604C3A0C50D7B6EC231A5"}
`with_comment_filter_words`	boolean	Example: false
`commercial_video_info`	string	Example:
`item_comment_settings`	integer	Example: 0
`mentioned_users`	string	Example: 6821528796420703237
`author`	object
`id`	string	Example: 107955
`unique_id`	string	Example: tiktok
`nickname`	string	Example: TikTok
`avatar`	string	Example: https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-006
`is_nff_or_nr`	boolean	Example: false

Status Codes

200: Success (code === 0). Charged according to the endpoint credit rate.
400: Invalid parameters, or API key placed in the URL query string (not charged).
401: Missing or invalid x-api-key header (not charged).
402: Insufficient credit balance (not charged).
403: Account disabled (not charged).
404: Unknown endpoint or disabled unstable endpoint (not charged).
405: Method not allowed — all /v1/* data endpoints use GET (not charged).
429: Rate limit exceeded (not charged). Respect the Retry-After header.
503: Temporary upstream or gateway error (not charged). Retry with exponential backoff.

Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.