← API Store
Social
TikTok
TikTok
One TikTok video
GET /tiktok/v1/postEvery response includes credits_used: the credits this call cost.
Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
urlrequired | string | Example: https://www.tiktok.com/@nasa/video/7697300954667994381 |
Every endpoint also takes: raw、fields、fresh、output、records
{
"ai_generated": null,
"author": {
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=…",
"id": "7664638705177150477",
"nickname": "NASA",
"username": "nasa",
"verified": true
},
"author_info": {
"avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=96…",
"avatar_thumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:100:100.jpeg?dr=96…",
"private": false,
"sec_uid": "MS4wLjABAAAAU9BRVzC8oCaegVnia8IbqWhPb_-dbU7s00Y3wS1_Nx8g5RUaYvyXrpejgjdxTwd6",
"signature": "Making the seemingly impossible, possible.✨",
"url": "https://www.tiktok.com/@nasa"
},
"author_stats": {
"diggCount": "356",
"followerCount": "2100000",
"followingCount": "23",
"friendCount": "0",
"heart": "11300000",
"heartCount": "11300000",
"videoCount": "58"
},
"cached": false,
"challenges": [],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocERRGQkjGFMAfD9CgfkFlASA6IARAlMDk0qnE~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"create_time": "2026-10-16T16:19:26.000Z",
"create_time_unix": 1792167566,
"credits_used": 1,
"desc": "There was plenty to see across NASA this week 🚀 🔴 Perseverance breaks a record on Mars 🛰️ Fresh cargo arrives at the ISS 🌌 CRS-35’s space …",
"diversification_labels": [
"Science",
"Education",
"… 1 more"
],
"duet_enabled": true,
"duration": 121,
"hashtags": [],
"id": "7697300954667994381",
"images": [],
"is_ad": false,
"location_created": "US",
"mentions": [],
"music": {
"author": "NASA",
"id": "7697301026352728845",
"title": "original sound - NASA"
},
"music_info": {
"album": null,
"cover": "https://p16-common.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e5143212a59c09a008bf50f487d54d1f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=…",
"duration": 121,
"original": false,
"play_url": "https://v16m.tiktokcdn-us.com/0e8ee318ca18d916bcd251f1d085bee5/6adc0e64/video/tos/useast5/tos-useast5-v-27dcd7-tx/oUSAMkAMigODJA6tB4LHaHTiEA…"
},
"page": {
"shareMeta": {
"desc": "There was plenty to see across NASA this week 🚀 🔴 Perseverance breaks a record on Mars 🛰️ Fresh cargo arrives at the ISS 🌌 CRS-35’s space …",
"title": "NASA on TikTok"
},
"statusCode": 0,
"statusMsg": ""
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "1579",
"commentCount": "514",
"diggCount": "21300",
"playCount": "389600",
"repostCount": "0",
"shareCount": "586"
},
"stitch_enabled": true,
"suggested_words": [
"JellyFish Lighting",
"nasa space",
"… 8 more"
],
"url": "https://www.tiktok.com/@nasa/video/7697300954667994381",
"video": {
"bitrate": 922075,
"bitrates": [
{
"bitrate": 922075,
"codec": "h264",
"gear": "normal_720_0",
"height": 1280,
"quality": 10,
"size": "13957923",
"urls": [
"https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/oYS1ASVNiJsiV7TAbwcIasYTIcNgBBQzCfFEdp/?a=1988&bti=ODszNWYu…",
"https://v19-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/oYS1ASVNiJsiV7TAbwcIasYTIcNgBBQzCfFEdp/?a=1988&bti=ODszNWYu…",
"… 1 more"
],
"width": 720
},
{
"bitrate": 524596,
"codec": "h265_hvc1",
"gear": "adapt_lower_720_1",
"height": 1280,
"quality": 14,
"size": "5695221",
"urls": [
"https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-v-0068-tx/oIY1YOcgAAAzAI70wIisaVpBJfNdVdSiBCADSg/media-video-hvc1/?a=19…",
"https://v19-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-v-0068-tx/oIY1YOcgAAAzAI70wIisaVpBJfNdVdSiBCADSg/media-video-hvc1/?a=19…",
"… 1 more"
],
"width": 720
},
"… 1 more"
],
"codec": "h264",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocERRGQkjGFMAfD9CgfkFlASA6IARAlMDk0qnE~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"definition": "720p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/okdzT1aTfAAbQNBJCqBScYEwgiIaSaDMVpiIBs/?a=1988&bti=ODszNWYu…",
"dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocERRGQkjGFMAfD9CgfkFlASA6IARAlMDk0qnE~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"format": "mp4",
"height": 1280,
"origin_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooBgb7TTAw4EkmSqR4YBDqA5pEQvQBFSmfl0fD~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-pve-0068-tx/oYS1ASVNiJsiV7TAbwcIasYTIcNgBBQzCfFEdp/?a=1988&bti=ODszNWYu…",
"quality": "normal",
"ratio": "720p",
"size": "13957923",
"subtitles": [
{
"format": "webvtt",
"language": "eng-US",
"source": "ASR",
"url": "https://v16m-webapp.tiktokcdn-us.com/10a7e585ebadfafda7ad87e65af9fa05/6ade5d04/video/tos/useast5/tos-useast5-v-0068-tx/094c4a073d7245fd970de…"
}
],
"width": 720
}
} Response fields (103)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.ai_generated | null |
$.author | object |
$.author.avatar | string |
$.author.id | string |
$.author.nickname | string |
$.author.username | string |
$.author.verified | boolean |
$.author_info | object |
$.author_info.avatar_medium | string |
$.author_info.avatar_thumb | string |
$.author_info.private | boolean |
$.author_info.sec_uid | string |
$.author_info.signature | string |
$.author_info.url | string |
$.author_stats | object |
$.author_stats.diggCount | string |
$.author_stats.followerCount | string |
$.author_stats.followingCount | string |
$.author_stats.friendCount | string |
$.author_stats.heart | string |
$.author_stats.heartCount | string |
$.author_stats.videoCount | string |
$.cached | boolean |
$.challenges | array |
$.cover | string |
$.create_time | string |
$.create_time_unix | integer |
$.credits_used | integer |
$.desc | string |
$.diversification_labels | array |
$.diversification_labels[] | string |
$.duet_enabled | boolean |
$.duration | integer |
$.hashtags | array |
$.id | string |
$.images | array |
$.is_ad | boolean |
$.location_created | string |
$.mentions | array |
$.music | object |
$.music.author | string |
$.music.id | string |
$.music.title | string |
$.music_info | object |
$.music_info.album | null |
$.music_info.cover | string |
$.music_info.duration | integer |
$.music_info.original | boolean |
$.music_info.play_url | string |
$.page | object |
$.page.shareMeta | object |
$.page.shareMeta.desc | string |
$.page.shareMeta.title | string |
$.page.statusCode | integer |
$.page.statusMsg | string |
$.pinned | null |
$.poi | null |
$.private_item | boolean |
$.share_enabled | boolean |
$.stats | object |
$.stats.collectCount | string |
$.stats.commentCount | string |
$.stats.diggCount | string |
$.stats.playCount | string |
$.stats.repostCount | string |
$.stats.shareCount | string |
$.stitch_enabled | boolean |
$.suggested_words | array |
$.suggested_words[] | string |
$.url | string |
$.video | object |
$.video.bitrate | integer |
$.video.bitrates | array |
$.video.bitrates[] | object | string |
$.video.bitrates[].bitrate | integer |
$.video.bitrates[].codec | string |
$.video.bitrates[].gear | string |
$.video.bitrates[].height | integer |
$.video.bitrates[].quality | integer |
$.video.bitrates[].size | string |
$.video.bitrates[].urls | array |
$.video.bitrates[].urls[] | string |
$.video.bitrates[].width | integer |
$.video.codec | string |
$.video.cover | string |
$.video.definition | string |
$.video.download_url | string |
$.video.dynamic_cover | string |
$.video.format | string |
$.video.height | integer |
$.video.origin_cover | string |
$.video.play_url | string |
$.video.quality | string |
$.video.ratio | string |
$.video.size | string |
$.video.subtitles | array |
$.video.subtitles[] | object |
$.video.subtitles[].format | string |
$.video.subtitles[].language | string |
$.video.subtitles[].source | string |
$.video.subtitles[].url | string |
$.video.width | integer |