← API Store
Social
TikTok
TikTok
TikTok videos for a keyword (public hashtag feed)
GET /tiktok/v1/searchEvery response includes credits_used: the credits this call cost.
The public hashtag feed for the keyword (spaces removed): the videos TikTok files under #<keyword>, 30 per page. For TikTok's own keyword search use /tiktok/v1/search/keyword.
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; `next_cursor` is null on the last page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 30,
"credits_used": 5,
"pages": [
{
"cursor": "30",
"extra": {
"fatal_item_ids": [],
"logid": "20261023194636D71FC7CD25EFF248E5B6",
"now": 1792784797000
},
"hasMore": true,
"log_pb": {
"impr_id": "20261023194636D71FC7CD25EFF248E5B6"
},
"statusCode": 0,
"status_code": 0,
"status_msg": ""
}
],
"query": "cooking",
"source": "hashtag #cooking",
"videos": [
{
"ai_generated": null,
"author": {
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/db81b659d4224bce4d93eb04ac625022~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=…",
"id": "7521686775371842591",
"nickname": "Shanye",
"username": "tftk007",
"verified": false
},
"author_info": {
"avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/db81b659d4224bce4d93eb04ac625022~tplv-tiktokx-cropcenter:720:720.jpeg?dr=96…",
"avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/db81b659d4224bce4d93eb04ac625022~tplv-tiktokx-cropcenter:100:100.jpeg?dr=96…",
"private": false,
"sec_uid": "MS4wLjABAAAARrAQ-DolrigX0zNo4UVvGyixVUhH7ZAEJs4dc-__utkItYr-_EuxA_4MYC45sxMl",
"signature": "For business cooperation email address:[email protected]",
"url": "https://www.tiktok.com/@tftk007"
},
"author_stats": {
"diggCount": "365",
"followerCount": "3000000",
"followingCount": "2",
"friendCount": "0",
"heart": "60900000",
"heartCount": "60900000",
"videoCount": "328"
},
"challenges": [
{
"desc": null,
"id": "1689794738682881",
"title": "cookingforest"
},
{
"desc": null,
"id": "76472060",
"title": "outdoorcooking"
},
"… 7 more"
],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0fdsvDljqYfIgEuirgFlEiDBcumuQR08vSAFD~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"create_time": "2026-09-28T10:40:31.000Z",
"create_time_unix": 1790592031,
"desc": "#cookingforest#outdoorcooking #cooking #Recipe #beef #survivor#cookingasmr #leon#outdoorcooking #cookingnature",
"diversification_labels": null,
"duet_enabled": true,
"duration": 363,
"hashtags": [
"cookingforest",
"outdoorcooking",
"… 8 more"
],
"id": "7690533903756561678",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "Dương Cường Camera",
"id": "7061837257761639194",
"title": "nhạc nền - Dương Cường Digital Camera"
},
"music_info": {
"album": null,
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/feaa1c8c3939bb76e9c4c24029524ce9~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&…",
"duration": 428,
"original": true,
"play_url": "https://v16m.tiktokcdn-us.com/16c863a2886c3ff0dddaa3df42092b2e/6adc0fa9/video/tos/useast5/tos-useast5-v-27dcd7c799-tx/9e06825ae0384161adfde3…"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "1552",
"commentCount": "353",
"diggCount": "16400",
"playCount": "155200",
"repostCount": "0",
"shareCount": "969"
},
"stitch_enabled": true,
"suggested_words": null,
"url": "https://www.tiktok.com/@tftk007/video/7690533903756561678",
"video": {
"bitrate": 3175707,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 2 more"
],
"codec": "h264",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0fdsvDljqYfIgEuirgFlEiDBcumuQR08vSAFD~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"definition": "720p",
"download_url": null,
"dynamic_cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/okysI5BqDgEI5KRzxi3DfDXA6O9Bui3ejSwRVE~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/ogAC6iwOeuyDBRaSRfsBj2E3gSiYDu0IXqhVIz~tplv-tiktokx-origin.image?dr=9636&x-ex…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c001-tx/o4ROsDOVA3vEXSXqzjSiiewuIBsfoJm6EgBREy/?a=1988&bti=ODszN…",
"quality": "normal",
"ratio": "720p",
"size": 144428807,
"subtitles": [],
"width": 720
}
},
{
"ai_generated": null,
"author": {
"avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"id": "7303785690449314859",
"nickname": "us_delicious_cooking",
"username": "us_delicious_cooking",
"verified": false
},
"author_info": {
"avatar_medium": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
"avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…",
"private": false,
"sec_uid": "MS4wLjABAAAAYoV2_uqInLEaYr7zVS4HgJQU_HXX9wSodGsq_KvJJbGHxsEoNlPn3NUeT1ppx-sl",
"signature": "",
"url": "https://www.tiktok.com/@us_delicious_cooking"
},
"author_stats": {
"diggCount": "1",
"followerCount": "220500",
"followingCount": "0",
"friendCount": "0",
"heart": "1600000",
"heartCount": "1600000",
"videoCount": "1186"
},
"challenges": [
{
"desc": "Share your favorite #Recipes.",
"id": "4436280",
"title": "recipes"
},
{
"desc": "Share an #easyrecipe for Singapore's local food! 10 mouthwatering entries will stand to win $100 NTUC FairPrice vouchers each. 😋🎉\n\nFrom 7 to…",
"id": "29431938",
"title": "EasyRecipe"
},
"… 14 more"
],
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o0dgotFa1IDDenDJEGGAf6EEVqQlDmZIqkZveC~tplv-tiktokx-origin.image?dr=9636&x…",
"create_time": "2026-09-24T19:23:10.000Z",
"create_time_unix": 1790277790,
"desc": "#recipes #easyrecipe #cooking #dinnerideas #yummyfood #dinnermadeeasy #foodtok #homecooking #quickrecipes #simplemeals #easycooking #foodide…",
"diversification_labels": null,
"duet_enabled": true,
"duration": 1183,
"hashtags": [
"recipes",
"easyrecipe",
"… 14 more"
],
"id": "7689185590528576799",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "us_delicious_cooking",
"id": "7689186070201715487",
"title": "original sound"
},
"music_info": {
"album": null,
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/633f2ad116bf9cc480f3d6e578904c4a~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"duration": 1180,
"original": true,
"play_url": "https://v16m.tiktokcdn-us.com/5c93f087d7bfb25adcfae03753746f15/6adc1299/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oIASeIveVIATF8NLEGCO6xmaL…"
},
"pinned": null,
"poi": null,
"private_item": false,
"share_enabled": true,
"stats": {
"collectCount": "2504",
"commentCount": "43",
"diggCount": "2407",
"playCount": "262200",
"repostCount": "0",
"shareCount": "1192"
},
"stitch_enabled": true,
"suggested_words": null,
"url": "https://www.tiktok.com/@us_delicious_cooking/video/7689185590528576799",
"video": {
"bitrate": 1838382,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 2 more"
],
"codec": "h264",
"cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o0dgotFa1IDDenDJEGGAf6EEVqQlDmZIqkZveC~tplv-tiktokx-origin.image?dr=9636&x…",
"definition": "720p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-85c255-tx2/oYFDDEAZQEVnocg4ICq91qFk6aGOeIfvnAJXEe/?a=1988&bti=ODszNWY…",
"dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o4FEaKFVaJsoI1eFEn6vVDeCqSqfQoZXgEGAQD~tplv-tiktokx-origin.image?dr=9636&x…",
"format": "mp4",
"height": 1280,
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-85c255-tx2/o80oQGFvH6qeG1fqIDDJQEanDEVA8CdgZvEZfx~tplv-tiktokx-origin.image?dr=9636&x…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-85c255-tx2/ocfV0oDdgqDaZqIE9fFEeQ2oIGG6IACnv1oqEJ/?a=1988&bti=ODszNWY…",
"quality": "normal",
"ratio": "720p",
"size": 272027050,
"subtitles": [
{
"…": "4 fields"
}
],
"width": 720
}
},
"… 28 more"
]
} Response fields (107)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.count | integer |
$.credits_used | integer |
$.pages | array |
$.pages[] | object |
$.pages[].cursor | string |
$.pages[].extra | object |
$.pages[].extra.fatal_item_ids | array |
$.pages[].extra.logid | string |
$.pages[].extra.now | integer |
$.pages[].hasMore | boolean |
$.pages[].log_pb | object |
$.pages[].log_pb.impr_id | string |
$.pages[].statusCode | integer |
$.pages[].status_code | integer |
$.pages[].status_msg | string |
$.query | string |
$.source | 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 |
$.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 |
$.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 | null | 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 |