Search APIs
Loading…
← API Store
Social

TikTok

TikTok

TikTok Top search (videos and accounts)

GET /tiktok/v1/search/top
Test this endpoint

Every 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

NameTypeDescription
qrequiredstring Example: gordon ramsay
cursorstringValue 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
$.cachedboolean
$.countinteger
$.credits_usedinteger
$.next_cursorstring
$.other_resultsarray
$.querystring
$.resultsarray
$.results[]object | string
$.results[].ai_generatednull
$.results[].authorobject
$.results[].author.avatarstring
$.results[].author.idstring
$.results[].author.nicknamestring
$.results[].author.usernamestring
$.results[].author.verifiedboolean
$.results[].author_infoobject
$.results[].author_info.avatar_mediumstring
$.results[].author_info.avatar_thumbstring
$.results[].author_info.privateboolean
$.results[].author_info.sec_uidstring
$.results[].author_info.signaturestring
$.results[].author_info.urlstring
$.results[].author_statsobject
$.results[].author_stats.diggCountstring
$.results[].author_stats.followerCountstring
$.results[].author_stats.followingCountstring
$.results[].author_stats.friendCountstring
$.results[].author_stats.heartstring
$.results[].author_stats.heartCountstring
$.results[].author_stats.videoCountstring
$.results[].challengesarray
$.results[].challenges[]object | string
$.results[].challenges[].descnull
$.results[].challenges[].idstring
$.results[].challenges[].titlestring
$.results[].coverstring
$.results[].create_timestring
$.results[].create_time_unixinteger
$.results[].descstring
$.results[].diversification_labelsnull
$.results[].doc_idstring
$.results[].duet_enabledboolean
$.results[].durationinteger
$.results[].hashtagsarray
$.results[].hashtags[]string
$.results[].idstring
$.results[].imagesarray
$.results[].is_adboolean
$.results[].location_creatednull
$.results[].mentionsarray
$.results[].musicobject
$.results[].music.authorstring
$.results[].music.idstring
$.results[].music.titlestring
$.results[].music_infoobject
$.results[].music_info.albumnull
$.results[].music_info.coverstring
$.results[].music_info.durationinteger
$.results[].music_info.originalboolean
$.results[].music_info.play_urlstring
$.results[].pinnednull
$.results[].poinull
$.results[].private_itemboolean
$.results[].result_typeinteger
$.results[].share_enabledboolean
$.results[].statsobject
$.results[].stats.collectCountstring
$.results[].stats.commentCountstring
$.results[].stats.diggCountstring
$.results[].stats.playCountstring
$.results[].stats.repostCountstring
$.results[].stats.shareCountstring
$.results[].stitch_enabledboolean
$.results[].suggested_wordsnull
$.results[].typestring
$.results[].urlstring
$.results[].usersarray
$.results[].users[]object
$.results[].users[].avatarstring
$.results[].users[].avatarsobject
$.results[].users[].avatars.…string
$.results[].users[].bio_linknull
$.results[].users[].commercenull
$.results[].users[].created_atnull
$.results[].users[].followersinteger
$.results[].users[].followingnull
$.results[].users[].friendsnull
$.results[].users[].idstring
$.results[].users[].languagenull
$.results[].users[].likesinteger
$.results[].users[].likes_givennull
$.results[].users[].nicknamestring
$.results[].users[].organizationnull
$.results[].users[].privateboolean
$.results[].users[].raw_cardobject
$.results[].users[].raw_card.…string
$.results[].users[].raw_statsnull
$.results[].users[].regionnull
$.results[].users[].sec_uidstring
$.results[].users[].secretnull
$.results[].users[].signaturestring
$.results[].users[].urlstring
$.results[].users[].usernamestring
$.results[].users[].verifiedboolean
$.results[].users[].videosnull
$.results[].videoobject
$.results[].video.bitrateinteger
$.results[].video.bitratesarray
$.results[].video.bitrates[]object | string
$.results[].video.bitrates[].…string
$.results[].video.codecstring
$.results[].video.coverstring
$.results[].video.definitionstring
$.results[].video.download_urlstring
$.results[].video.dynamic_coverstring
$.results[].video.formatstring
$.results[].video.heightinteger
$.results[].video.origin_coverstring
$.results[].video.play_urlstring
$.results[].video.qualitystring
$.results[].video.ratiostring
$.results[].video.sizeinteger
$.results[].video.subtitlesarray
$.results[].video.subtitles[]object
$.results[].video.subtitles[].…string
$.results[].video.widthinteger