TikTok Video Detail API
Query public TikTok data synchronously; empty results and failures are free.
Results return directly in the same request; no task submission or polling is needed.
Open product page and API TesterEndpoint and authentication
GET https://api.goanyapi.com/api/v1/tiktok/video-detailAuthenticate with Authorization: Bearer YOUR_API_KEY. Supply query-string parameters; there is no request body.
Input parameters
| Parameter | Type | Location | Required | Constraints / default | Description |
|---|---|---|---|---|---|
Authorization | string | Header | Yes | Bearer YOUR_API_KEY | API key for the current account |
item_id | string | Query | One of two | ^[0-9]+$ | Video ID. Example: 7686957509826923808. |
url | string | Query | One of two | ^https://(www\.)?tiktok\.com/@[A-Za-z0-9._]+/video/[0-9]+/?(?:\?[^#\s]*)?(?:#[^\s]*)?$ | Full TikTok video URL. Example: https://www.tiktok.com/@spidey.glow/video/7686957509826923808. Supply either url or item_id, never both. Sharing parameters and fragments are removed. Short links are unsupported. URL resolution adds no separate credit charge. |
Full URL supported: https://www.tiktok.com/@spidey.glow/video/7686957509826923808. Supply either url or item_id, never both. Sharing parameters, fragments and trailing slashes are removed; short links are unsupported. URL format handling adds no separate charge.
Request example
GET /api/v1/tiktok/video-detail?url=https%3A%2F%2Fwww.tiktok.com%2F%40spidey.glow%2Fvideo%2F7686957509826923808
Authorization: Bearer YOUR_API_KEYOutput parameters
Success returns HTTP 200. Null, empty and missing business fields are preserved; a zero statistic is valid. Only documented public fields are returned.
| Field | Type | Description |
|---|---|---|
code | string | ok on success |
message | string | Request message |
data.creditsUsed | number | Credits charged for this request; zero for empty results |
data.remainingCredits | number | Account balance after settlement |
data.item | object | null | Video details; null when empty |
data.item.id | string | Post ID |
data.item.desc | string | Post description |
data.item.createTime | number | Unix timestamp in seconds |
data.item.isAd | boolean | Advertisement indicator |
data.item.author | object | Author information |
data.item.stats | object | Engagement statistics |
data.item.statsV2 | object | String statistics |
data.item.video | object | Video media information |
data.item.author.id | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.uniqueId | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.nickname | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.signature | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.secUid | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.avatarThumb | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.avatarMedium | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.avatarLarger | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.verified | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.privateAccount | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.author.createTime | string | number | boolean | null | Returned public author field; may be absent or empty |
data.item.video.id | string | number | null | Returned public media field; may be absent or empty |
data.item.video.desc | string | number | null | Returned public media field; may be absent or empty |
data.item.video.createTime | string | number | null | Returned public media field; may be absent or empty |
data.item.video.duration | string | number | null | Returned public media field; may be absent or empty |
data.item.video.width | string | number | null | Returned public media field; may be absent or empty |
data.item.video.height | string | number | null | Returned public media field; may be absent or empty |
data.item.video.ratio | string | number | null | Returned public media field; may be absent or empty |
data.item.video.cover | string | number | null | Returned public media field; may be absent or empty |
data.item.video.originCover | string | number | null | Returned public media field; may be absent or empty |
data.item.video.dynamicCover | string | number | null | Returned public media field; may be absent or empty |
data.item.video.playAddr | string | number | null | Returned public media field; may be absent or empty |
data.item.video.downloadAddr | string | number | null | Returned public media field; may be absent or empty |
data.item.stats.diggCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.shareCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.commentCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.playCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.collectCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.followerCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.followingCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.heartCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.heart | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.videoCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.friendCount | number | string | null | Returned statistic; may be absent or empty |
data.item.stats.viewCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.diggCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.shareCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.commentCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.playCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.collectCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.followerCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.followingCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.heartCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.heart | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.videoCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.friendCount | number | string | null | Returned statistic; may be absent or empty |
data.item.statsV2.viewCount | number | string | null | Returned statistic; may be absent or empty |
Real response example
Saved from a real successful response and projected to public fields. Lists show only the first two records. Account balance and request charges are omitted; live responses also contain creditsUsed and remainingCredits based on current configuration. Displaying the example sends no query and charges no credits.
{
"code": "ok",
"message": "ok",
"data": {
"item": {
"id": "7686957509826923808",
"desc": "Comment “SANTA” if you need one 🤭🎄 #christmas #christmasiscoming #projector #merrychristmas #christmasdecor ",
"createTime": 1789759268,
"isAd": false,
"author": {
"id": "7672400417817625622",
"uniqueId": "spidey.glow",
"nickname": "SpideyGlow",
"signature": "",
"secUid": "MS4wLjABAAAAK4RIcIbr3DY__BALfxpDu7FXrXMdNIkck5Zzt7ScvdWxtGgRjeLDOCixGr4nFQrG",
"avatarThumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=a34c0f1e&x-expires=1794646800&x-signature=YMzBmDgoFv2S4Kui2XY0XXEDhwI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarMedium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=18965771&x-expires=1794646800&x-signature=k%2FtqwEg%2FG2ewpHJw%2FxdKOhdeRm0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-euttp/58cb4b19080af86926f621f3ced3a91d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=eb2f6582&x-expires=1794646800&x-signature=8MwRsymAfh8mqWKXlfe5Z%2BzlRKk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
"verified": false,
"privateAccount": false
},
"stats": {
"diggCount": 11100,
"shareCount": 7166,
"commentCount": 491,
"playCount": 1000000,
"collectCount": 2423
},
"statsV2": {
"diggCount": "11100",
"shareCount": "7166",
"commentCount": "491",
"playCount": "1000000",
"collectCount": "2423"
},
"video": {
"id": "7686957509826923808",
"duration": 14,
"width": 576,
"height": 1024,
"ratio": "540p",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/owHQfADrKH1DkFRNqzPJ6CmEQIebBDgQunkYEV~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=LtUxvaSud4oEjRkn9Wfiz2T1YwA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"originCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oYEsyqotmiQaZSh1AlBgIjItfdCaPABznByIVi~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=7L%2BLsb1IUpQZz7Zufap2OlxC9sw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"dynamicCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-p-0037-euttp/oMyimjqyIZyCzGVAntZBfBlIdEAiCUsoEzi1Ih~tplv-tiktokx-origin.image?dr=9636&x-expires=1794646800&x-signature=Q%2FrsN7LCrnTEr0lVcZ0C7TzAUas%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5",
"playAddr": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast2a/tos-useast2a-ve-0068c001-euttp/ow1EVtFrPQDeJkgA6K9QfDEzqbIHRqNDmDmYHB/?a=1988&bti=ODszNWYuMDE6&&bt=1087&ft=4KJMyMzm8Zmo0FcjMa4jVJyedpWrKsd.&mime_type=video_mp4&rc=aTM6NzY1aDY5PDY0ZjxmZ0Bpajp0cmw5cjVyZDMzZjczNUA0NjBjLWNiXzUxYS0tM2AxYSNmaWBgMmRjcWphLS1kMTNzcw%3D%3D&expire=1794648888&l=202611120934347C1B176E04FFD2014F20&ply_type=2&policy=2&signature=7960f205a17931084ce957cd56b59cab&tk=tt_chain_token&btag=e000b8000",
"downloadAddr": "https://video-useast5-bp.us.tiktok.com/b63e11495ffdb3e6ff708d815695a650/6af82b38/kmoat/mps/logo/v3/r/p/v26044gc0000damot2fog65icocql7ig/d3a2b34d8a654b1299c10af3e9527c90/07f34a1c8d363dc39fbe34e3c4004545/mp4/main.mp4?a=1988&bti=ODszNWYuMDE6&&bt=0&ft=4KUERMzm8Zmo0FcjMa4jVJyedpWrKsd.&mime_type=video_mp4&rc=cnF8b2hsc2d3SkBwaHIxaDFybndmM2Y1PDZkNDw1ZThkZzY1NkBpajp0cmw5cjVyZDMzZjczNUBjRl5Nc3FePmJKYSNvYF90aHFmOiM2NDJiYy1gNi4xMzUxX15hYSNmaWBgMmRjcWphLS1kMTNzcw%3D%3D&definition=720p&du=15&item_id=7686957509826923808&l=202611120934347C1B176E04FFD2014F20&logo_type=tiktok_creator&ply_type=2&policy=eyJ2bSI6MiwiY2siOiJ0dF9jaGFpbl90b2tlbiJ9&sign_params=item_id%2Cuser_text&user_text=spidey.glow&btag=e000b8000"
}
}
}
}Billing
With the current configuration, each successful request costs 1 credit.
Non-empty successful results use the currently configured rate; empty results and failures are free. Sufficient balance is required before requesting. A concurrent settlement with insufficient balance also returns 402 without delivering unsettled paid results. Empty or null details and lists without meaningful records are empty; individual empty fields do not make a populated result empty.
Errors
400: invalid parameters; 401: invalid authentication; 402: insufficient credits; 429: rate limit; 502: request failed; 503: API or pricing not configured. Errors contain code and message without internal addresses or credentials.
{"code":"invalid_params","message":"Invalid parameter"}