← API Store
Social
TikTok
TikTok
Search TikTok videos
GET /tiktok/v1/search/keywordEvery 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 |
|---|---|---|
qrequired | string | Example: cooking |
cursor | string | Value of `next_cursor` from the previous page. |
date | all | day | week | month | 3months | 6months | Date posted: all (default), day, week, month, 3months, 6months. |
sort | relevance | likes | relevance (default) or likes. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 19,
"credits_used": 1,
"next_cursor": "20|2026102319462506A27FBE5343885A3772",
"query": "cooking",
"videos": [
{
"ai_generated": null,
"author": {
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"id": "7659299286202729485",
"nickname": "boieqmdk8rc",
"username": "boieqmdk8rc",
"verified": false
},
"author_info": {
"avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
"avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…",
"private": false,
"sec_uid": "MS4wLjABAAAAz96wnaw0Rqe5nl_CInRMfmeDtaDa3LXxTQ7ZOIfZ7HrfBQaewFQtDUWmqWRLZ49Q",
"signature": "",
"url": "https://www.tiktok.com/@boieqmdk8rc"
},
"author_stats": {
"diggCount": "0",
"followerCount": "15300",
"followingCount": "0",
"friendCount": "0",
"heart": "133100",
"heartCount": "133100",
"videoCount": "38"
},
"challenges": [
{
"desc": null,
"id": "18973",
"title": "cooking"
},
{
"desc": "Whether you're baking a cake or perfecting a recipe, we're here for all things #CookingTikTok.",
"id": "1607060250419201",
"title": "cookingtiktok"
},
"… 3 more"
],
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osfRIE3R6tYmTPzC2eB3QnyHABFDEqAQYiDV2E~tplv-tiktokx-origin.image?dr=9636&x-e…",
"create_time": "2026-07-22T18:38:23.000Z",
"create_time_unix": 1784745503,
"desc": "#cooking #cookingtiktok #cookingvideos #food #fyp ",
"diversification_labels": null,
"duet_enabled": true,
"duration": 153,
"hashtags": [
"cooking",
"cookingtiktok",
"… 3 more"
],
"id": "7665423468699094303",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "boieqmdk8rc",
"id": "7665423485962930974",
"title": "original sound - boieqmdk8rc"
},
"music_info": {
"album": null,
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/354d2f174f5a06ee40d0fe21b4cd75df~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"duration": 153,
"original": true,
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-27dcd7-tx2/owBE4iDOFA9jYDh4AJlnCBTUQuoEEVAfAqQfEE/?a=1988&bti=ODszNWY…"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "93",
"commentCount": "6",
"diggCount": "170",
"playCount": "15300",
"repostCount": "0",
"shareCount": "41"
},
"stitch_enabled": true,
"suggested_words": null,
"url": "https://www.tiktok.com/@boieqmdk8rc/video/7665423468699094303",
"video": {
"bitrate": 563852,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 1 more"
],
"codec": "h264",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osfRIE3R6tYmTPzC2eB3QnyHABFDEqAQYiDV2E~tplv-tiktokx-origin.image?dr=9636&x-e…",
"definition": "540p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oklyIQiRDIjD6Ct3AiFgVFRY2BfeqwEQEWAzEY/?a=1988&bti=ODszNWY…",
"dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/okAABDIaQoERmIihbo5dNPEZ5Bis2B5zERV2o~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"format": "mp4",
"height": 1024,
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oA0RbIm2PR2GABiDiR2Ioh5EAEBaBVNCo5pd7~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oAo5ApViaPDEVB5RK2NrxAEbh2mQIREgBDidP/?a=1988&bti=ODszNWYu…",
"quality": "lowest",
"ratio": "540p",
"size": 10840066,
"subtitles": [
{
"…": "4 fields"
}
],
"width": 576
}
},
{
"ai_generated": null,
"author": {
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
"id": "7530266134588425232",
"nickname": "Food Partners",
"username": "foodpartners",
"verified": false
},
"author_info": {
"avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&re…",
"avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&re…",
"private": false,
"sec_uid": "MS4wLjABAAAAfeS8vYCa27jZCGYn7P18p92ZUNCYi9Am--ntYEz6TSXYW5OHErB6ITYElmY-nIf7",
"signature": "",
"url": "https://www.tiktok.com/@foodpartners"
},
"author_stats": {
"diggCount": "7",
"followerCount": "89900",
"followingCount": "0",
"friendCount": "0",
"heart": "618700",
"heartCount": "618700",
"videoCount": "117"
},
"challenges": [],
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/o4AAAFRY2O1IfBGA8DBCvEuEKbXKi4iwASyBxv~tplv-tiktokx-origin.image?dr=9636&x-expires…",
"create_time": "2026-10-21T06:38:51.000Z",
"create_time_unix": 1792564731,
"desc": "How to cook braosed pork and soup recipe",
"diversification_labels": null,
"duet_enabled": null,
"duration": 905,
"hashtags": [],
"id": "7699006867812388114",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "Food Partners",
"id": "7699007208801766165",
"title": "original sound - Food Partners"
},
"music_info": {
"album": null,
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/c2b00224ddd477cbd2b1e49f12fc8e35~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
"duration": 905,
"original": true,
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-v-27dcd7/oAENMQKfFlbIGjUJUd2qeQF4U0kDSXgBCG7JaB/?a=1988&bti=ODszNWYuMDE6&&b…"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "3364",
"commentCount": "338",
"diggCount": "21400",
"playCount": "1900000",
"repostCount": "0",
"shareCount": "670"
},
"stitch_enabled": null,
"suggested_words": null,
"url": "https://www.tiktok.com/@foodpartners/video/7699006867812388114",
"video": {
"bitrate": 3516272,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 2 more"
],
"codec": "h264",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/o4AAAFRY2O1IfBGA8DBCvEuEKbXKi4iwASyBxv~tplv-tiktokx-origin.image?dr=9636&x-expires…",
"definition": "1080p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/osB4b6V07Vli9iYhiSvYqIAAtEaEVliyiATWY/?a=1988&bti=ODszNWYuMDE6&&bt…",
"dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/o4AAAFRY2O1IfBGA8DBCvEuEKbXKi4iwASyBxv~tplv-tiktokx-origin.image?dr=9636&x-expires…",
"format": "mp4",
"height": 1920,
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-p-0037/owDLkVLCS2dIEeLrpVgL4LAojvAeYVLwhesgAG~tplv-tiktokx-origin.image?dr=9636&x-expires…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037/osB4b6V07Vli9iYhiSvYqIAAtEaEVliyiATWY/?a=1988&bti=ODszNWYuMDE6&&bt…",
"quality": "normal",
"ratio": "1080p",
"size": 397972193,
"subtitles": [],
"width": 1080
}
},
"… 17 more"
]
} Response fields (94)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.next_cursor | string |
$.query | string |
$.videos | array |
$.videos[] | object | string |
$.videos[].ai_generated | null |
$.videos[].author | object |
$.videos[].author.avatar | string |
$.videos[].author.id | string |
$.videos[].author.nickname | string |
$.videos[].author.username | string |
$.videos[].author.verified | boolean |
$.videos[].author_info | object |
$.videos[].author_info.avatar_medium | string |
$.videos[].author_info.avatar_thumb | string |
$.videos[].author_info.private | boolean |
$.videos[].author_info.sec_uid | string |
$.videos[].author_info.signature | string |
$.videos[].author_info.url | string |
$.videos[].author_stats | object |
$.videos[].author_stats.diggCount | string |
$.videos[].author_stats.followerCount | string |
$.videos[].author_stats.followingCount | string |
$.videos[].author_stats.friendCount | string |
$.videos[].author_stats.heart | string |
$.videos[].author_stats.heartCount | string |
$.videos[].author_stats.videoCount | string |
$.videos[].challenges | array |
$.videos[].challenges[] | object | string |
$.videos[].challenges[].desc | null | string |
$.videos[].challenges[].id | string |
$.videos[].challenges[].title | string |
$.videos[].cover | string |
$.videos[].create_time | string |
$.videos[].create_time_unix | integer |
$.videos[].desc | string |
$.videos[].diversification_labels | null |
$.videos[].duet_enabled | boolean | null |
$.videos[].duration | integer |
$.videos[].hashtags | array |
$.videos[].hashtags[] | string |
$.videos[].id | string |
$.videos[].images | array |
$.videos[].is_ad | boolean |
$.videos[].location_created | null |
$.videos[].mentions | array |
$.videos[].music | object |
$.videos[].music.author | string |
$.videos[].music.id | string |
$.videos[].music.title | string |
$.videos[].music_info | object |
$.videos[].music_info.album | null |
$.videos[].music_info.cover | string |
$.videos[].music_info.duration | integer |
$.videos[].music_info.original | boolean |
$.videos[].music_info.play_url | string |
$.videos[].pinned | null |
$.videos[].poi | null |
$.videos[].private_item | boolean |
$.videos[].share_enabled | boolean |
$.videos[].stats | object |
$.videos[].stats.collectCount | string |
$.videos[].stats.commentCount | string |
$.videos[].stats.diggCount | string |
$.videos[].stats.playCount | string |
$.videos[].stats.repostCount | string |
$.videos[].stats.shareCount | string |
$.videos[].stitch_enabled | boolean | null |
$.videos[].suggested_words | null |
$.videos[].url | string |
$.videos[].video | object |
$.videos[].video.bitrate | integer |
$.videos[].video.bitrates | array |
$.videos[].video.bitrates[] | object | string |
$.videos[].video.bitrates[].… | string |
$.videos[].video.codec | string |
$.videos[].video.cover | string |
$.videos[].video.definition | string |
$.videos[].video.download_url | string |
$.videos[].video.dynamic_cover | string |
$.videos[].video.format | string |
$.videos[].video.height | integer |
$.videos[].video.origin_cover | string |
$.videos[].video.play_url | string |
$.videos[].video.quality | string |
$.videos[].video.ratio | string |
$.videos[].video.size | integer |
$.videos[].video.subtitles | array |
$.videos[].video.subtitles[] | object |
$.videos[].video.subtitles[].… | string |
$.videos[].video.width | integer |