TikTok API: Get video details (v3)

Get a video's caption, publish time, author, engagement counts, cover, sound and hashtags, by id or by video url. Send exactly one. An unknown or removed video returns data: null.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

id?string

Numeric video ID from the video's URL or from any video list. Send this or url.

Match^\d{5,25}$

url?string

TikTok video link, including vm.tiktok.com share links. Send this or id.

Lengthlength <= 500

curl -X GET "https://example.com/v3/tiktok/video/details" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "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-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=3d2bb4f9&x-expires=1792335600&x-signature=%2BljQ7HPAJid7MbhQE0rtEUc4Gzg%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",      "verified": true    },    "stats": {      "plays": 1600000,      "likes": 104500,      "comments": 3048,      "shares": 3268,      "saves": 7591    },    "video": {      "duration": 25,      "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oAUhkWfCZC7g6ALj2HZgOeELFvIrALeFYOoGI4~tplv-tiktokx-origin.image?dr=9636&x-expires=1792335600&x-signature=Gj8tvE8jgxWby8SZIBVjJDY8gvs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",      "width": 720,      "height": 1280    },    "music": {      "id": "7665075815390645006",      "title": "original sound",      "author": "NASA"    },    "hashtags": []  }}