← API Store
Social
TikTok
TikTok
TikTok Top search (videos and accounts)
GET /tiktok/v1/search/topEvery 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: gordon ramsay |
cursor | string | Value of `next_cursor` from the previous page. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"count": 14,
"credits_used": 1,
"next_cursor": "12|20261023194629F3C9FACFCC361D4F5617",
"other_results": [],
"query": "gordon ramsay",
"results": [
{
"result_type": 4,
"type": "users",
"users": [
{
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7310612651137040390~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=…",
"avatars": {
"…": "3 fields"
},
"bio_link": null,
"commerce": null,
"created_at": null,
"followers": 40700000,
"following": null,
"friends": null,
"id": "6747935906352907269",
"language": null,
"likes": 730234444,
"likes_given": null,
"nickname": "Gordon Ramsay",
"organization": null,
"private": false,
"raw_card": {
"…": "8 fields"
},
"raw_stats": null,
"region": null,
"sec_uid": "MS4wLjABAAAAv3zolJLlWp-WbKXqSZwVSflDdwcbjPADRG-dhb68k30dQjkFpkRs4HiMvWeeIyVv",
"secret": null,
"signature": "I cook sometimes too.....",
"url": "https://www.tiktok.com/@gordonramsayofficial",
"username": "gordonramsayofficial",
"verified": false,
"videos": null
}
]
},
{
"ai_generated": null,
"author": {
"avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8773f64f997c67991f043281d50e00e9~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"id": "7647264189417964557",
"nickname": "grinddaily",
"username": "grinddaily55",
"verified": false
},
"author_info": {
"avatar_medium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8773f64f997c67991f043281d50e00e9~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9…",
"avatar_thumb": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8773f64f997c67991f043281d50e00e9~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9…",
"private": false,
"sec_uid": "MS4wLjABAAAAQFMraaiM_0abKivWicMIC1RGZUw4q2oji-k9MHl-FcCaM0OAJ6U5InWpsra5J0xt",
"signature": "Hey Guys this is Bratt. I am fan of Gordon Ramsay and i really like all his shows. I love to edit his videos by adding value to it to make i…",
"url": "https://www.tiktok.com/@grinddaily55"
},
"author_stats": {
"diggCount": "156",
"followerCount": "2407",
"followingCount": "1",
"friendCount": "0",
"heart": "268300",
"heartCount": "268300",
"videoCount": "302"
},
"challenges": [
{
"desc": null,
"id": "14301837",
"title": "gordonramsay"
},
{
"desc": null,
"id": "5176372",
"title": "kitchennightmares"
},
"… 2 more"
],
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oAeQeVODQ1wIq6tCB3fM8IEjIdAXCH1AsZdVgC~tplv-tiktokx-origin.image?dr=9636&x-e…",
"create_time": "2026-10-23T18:40:33.000Z",
"create_time_unix": 1792780833,
"desc": "Restaurant Served Gordon Ramsay a 1-Year-Old Lamb #gordonramsay #kitchennightmares #chef #tiktokgrowthchallenge ",
"diversification_labels": null,
"doc_id": "7699934951004704030",
"duet_enabled": true,
"duration": 29,
"hashtags": [
"gordonramsay",
"kitchennightmares",
"… 2 more"
],
"id": "7699934951004704030",
"images": [],
"is_ad": false,
"location_created": null,
"mentions": [],
"music": {
"author": "grinddaily",
"id": "7699935047788317471",
"title": "original sound"
},
"music_info": {
"album": null,
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/8773f64f997c67991f043281d50e00e9~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr…",
"duration": 29,
"original": true,
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-27dcd7-tx2/o0D6QKCVIAEYqWTghITEeOfE3FeGtLxR1qJVNo/?a=1988&bti=ODszNWY…"
},
"pinned": null,
"poi": null,
"private_item": false,
"result_type": 1,
"share_enabled": true,
"stats": {
"collectCount": "2",
"commentCount": "0",
"diggCount": "14",
"playCount": "622",
"repostCount": "0",
"shareCount": "0"
},
"stitch_enabled": true,
"suggested_words": null,
"type": "video",
"url": "https://www.tiktok.com/@grinddaily55/video/7699934951004704030",
"video": {
"bitrate": 1306861,
"bitrates": [
{
"…": "8 fields"
},
{
"…": "8 fields"
},
"… 1 more"
],
"codec": "h264",
"cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oAeQeVODQ1wIq6tCB3fM8IEjIdAXCH1AsZdVgC~tplv-tiktokx-origin.image?dr=9636&x-e…",
"definition": "720p",
"download_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/ocsgAEfEqA2FqOiVNIBkRHA9HQQeFvE3D8W6V3/?a=1988&bti=ODszNWY…",
"dynamic_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogIbIBEXRqX2AIDqGFDWfgJoRkeEOEXAVj6iBT~tplv-tiktokx-origin.image?dr=9636&x-e…",
"format": "mp4",
"height": 1280,
"origin_cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oAOxEGS2AkeRAIXiq3IvoJFTEjEbV6fqBgARDM~tplv-tiktokx-origin.image?dr=9636&x-e…",
"play_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/ooERXXEber9onVDjBAfRFGAVQkIgjEgOE62qqE/?a=1988&bti=ODszNWY…",
"quality": "normal",
"ratio": "720p",
"size": 4843881,
"subtitles": [
{
"…": "4 fields"
}
],
"width": 720
}
},
"… 12 more"
]
} Response fields (127)
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 |
$.other_results | array |
$.query | string |
$.results | array |
$.results[] | object | string |
$.results[].ai_generated | null |
$.results[].author | object |
$.results[].author.avatar | string |
$.results[].author.id | string |
$.results[].author.nickname | string |
$.results[].author.username | string |
$.results[].author.verified | boolean |
$.results[].author_info | object |
$.results[].author_info.avatar_medium | string |
$.results[].author_info.avatar_thumb | string |
$.results[].author_info.private | boolean |
$.results[].author_info.sec_uid | string |
$.results[].author_info.signature | string |
$.results[].author_info.url | string |
$.results[].author_stats | object |
$.results[].author_stats.diggCount | string |
$.results[].author_stats.followerCount | string |
$.results[].author_stats.followingCount | string |
$.results[].author_stats.friendCount | string |
$.results[].author_stats.heart | string |
$.results[].author_stats.heartCount | string |
$.results[].author_stats.videoCount | string |
$.results[].challenges | array |
$.results[].challenges[] | object | string |
$.results[].challenges[].desc | null |
$.results[].challenges[].id | string |
$.results[].challenges[].title | string |
$.results[].cover | string |
$.results[].create_time | string |
$.results[].create_time_unix | integer |
$.results[].desc | string |
$.results[].diversification_labels | null |
$.results[].doc_id | string |
$.results[].duet_enabled | boolean |
$.results[].duration | integer |
$.results[].hashtags | array |
$.results[].hashtags[] | string |
$.results[].id | string |
$.results[].images | array |
$.results[].is_ad | boolean |
$.results[].location_created | null |
$.results[].mentions | array |
$.results[].music | object |
$.results[].music.author | string |
$.results[].music.id | string |
$.results[].music.title | string |
$.results[].music_info | object |
$.results[].music_info.album | null |
$.results[].music_info.cover | string |
$.results[].music_info.duration | integer |
$.results[].music_info.original | boolean |
$.results[].music_info.play_url | string |
$.results[].pinned | null |
$.results[].poi | null |
$.results[].private_item | boolean |
$.results[].result_type | integer |
$.results[].share_enabled | boolean |
$.results[].stats | object |
$.results[].stats.collectCount | string |
$.results[].stats.commentCount | string |
$.results[].stats.diggCount | string |
$.results[].stats.playCount | string |
$.results[].stats.repostCount | string |
$.results[].stats.shareCount | string |
$.results[].stitch_enabled | boolean |
$.results[].suggested_words | null |
$.results[].type | string |
$.results[].url | string |
$.results[].users | array |
$.results[].users[] | object |
$.results[].users[].avatar | string |
$.results[].users[].avatars | object |
$.results[].users[].avatars.… | string |
$.results[].users[].bio_link | null |
$.results[].users[].commerce | null |
$.results[].users[].created_at | null |
$.results[].users[].followers | integer |
$.results[].users[].following | null |
$.results[].users[].friends | null |
$.results[].users[].id | string |
$.results[].users[].language | null |
$.results[].users[].likes | integer |
$.results[].users[].likes_given | null |
$.results[].users[].nickname | string |
$.results[].users[].organization | null |
$.results[].users[].private | boolean |
$.results[].users[].raw_card | object |
$.results[].users[].raw_card.… | string |
$.results[].users[].raw_stats | null |
$.results[].users[].region | null |
$.results[].users[].sec_uid | string |
$.results[].users[].secret | null |
$.results[].users[].signature | string |
$.results[].users[].url | string |
$.results[].users[].username | string |
$.results[].users[].verified | boolean |
$.results[].users[].videos | null |
$.results[].video | object |
$.results[].video.bitrate | integer |
$.results[].video.bitrates | array |
$.results[].video.bitrates[] | object | string |
$.results[].video.bitrates[].… | string |
$.results[].video.codec | string |
$.results[].video.cover | string |
$.results[].video.definition | string |
$.results[].video.download_url | string |
$.results[].video.dynamic_cover | string |
$.results[].video.format | string |
$.results[].video.height | integer |
$.results[].video.origin_cover | string |
$.results[].video.play_url | string |
$.results[].video.quality | string |
$.results[].video.ratio | string |
$.results[].video.size | integer |
$.results[].video.subtitles | array |
$.results[].video.subtitles[] | object |
$.results[].video.subtitles[].… | string |
$.results[].video.width | integer |