Search videos — TikTok API

Searches TikTok for videos matching a query. Supports filtering by publish time and sorting by relevance, likes, or date.

Get free API key View the docs

GET/v1/tiktok/search/videos1 credit per request

Example response200OK

{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "OrderedCollectionPage",
    "partOf": "https://api.konbiniapi.com/v1/tiktok/search/videos",
    "totalItems": 1309,
    "cursor": null,
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/tiktok/search/videos?query=khaby&cursor=1772217402000&count=30",
    "itemCount": 30,
    "orderedItems": [
      {
        "type": "Video",
        "id": "https://www.tiktok.com/@khaby.lame/video/7611615657754381599",
        "url": "https://www.tiktok.com/@khaby.lame/video/7611615657754381599",
        "entityId": "7611615657754381599",
        "content": "When you realize there is a simpler way #learnfromkhaby",
        "published": "2026-02-27T18:36:42.000Z",
        "duration": 23,
        "viewCount": 42600000,
        "likeCount": 2800000,
        "commentCount": 29200,
        "repostCount": 0,
        "shareCount": 157700,
        "saveCount": 153238,
        "language": "en",
        "isSponsored": false,
        "location": {
          "type": "Place",
          "name": "US"
        },
        "tag": [
          {
            "type": "Tag",
            "name": "learnfromkhaby",
            "href": "https://www.tiktok.com/tag/learnfromkhaby",
            "id": "https://www.tiktok.com/tag/learnfromkhaby",
            "entityId": "1697657584273413"
          }
        ],
        "attributedTo": {
          "type": "Person",
          "id": "https://www.tiktok.com/@khaby.lame",
          "url": "https://www.tiktok.com/@khaby.lame",
          "entityId": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
          "name": "Khabane Lame",
          "preferredUsername": "khaby.lame",
          "summary": "Just a guy who reacts",
          "attachment": [
            {
              "type": "Link",
              "href": "https://linktr.ee/khaby.lame",
              "rel": "preferred"
            }
          ],
          "published": "2020-03-15T00:00:00.000Z",
          "isPrivate": false,
          "isVerified": true,
          "isLive": false,
          "hasLikes": true,
          "hasPlaylists": true,
          "followerCount": 160300000,
          "followingCount": 85,
          "language": "en",
          "likeCount": 2600000000,
          "likedCount": 5300,
          "mediaCount": 1309,
          "icon": {
            "type": "Image",
            "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
            "width": 576,
            "height": 1024
          },
          "image": [
            {
              "type": "Image",
              "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
              "width": 576,
              "height": 1024
            }
          ]
        },
        "attachment": [
          {
            "type": "Video",
            "name": "normal_540_0",
            "url": [
              "https://v19-webapp.tiktok.com/video/tos/us/tos-useast5-ve-0068c004/video.mp4"
            ],
            "mediaType": "video/mp4",
            "codec": "h264",
            "width": 576,
            "height": 1024,
            "bitrate": 1101943
          }
        ],
        "image": [
          {
            "type": "Image",
            "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
            "width": 576,
            "height": 1024
          }
        ],
        "preview": {
          "type": "Image",
          "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
          "width": 576,
          "height": 1024
        },
        "audio": {
          "type": "Audio",
          "id": "https://www.tiktok.com/music/original-sound-7611615657754381599",
          "url": "https://sf16-ies-music.tiktokcdn.com/obj/tos-alisg-v/123456",
          "name": "original sound",
          "duration": 23,
          "mediaType": "audio/mpeg",
          "attributedTo": {
            "type": "Person",
            "id": "https://www.tiktok.com/@khaby.lame",
            "url": "https://www.tiktok.com/@khaby.lame",
            "entityId": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
            "name": "Khabane Lame",
            "preferredUsername": "khaby.lame",
            "summary": "Just a guy who reacts",
            "attachment": [
              {
                "type": "Link",
                "href": "https://linktr.ee/khaby.lame",
                "rel": "preferred"
              }
            ],
            "published": "2020-03-15T00:00:00.000Z",
            "isPrivate": false,
            "isVerified": true,
            "isLive": false,
            "hasLikes": true,
            "hasPlaylists": true,
            "followerCount": 160300000,
            "followingCount": 85,
            "language": "en",
            "likeCount": 2600000000,
            "likedCount": 5300,
            "mediaCount": 1309,
            "icon": {
              "type": "Image",
              "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
              "width": 576,
              "height": 1024
            },
            "image": [
              {
                "type": "Image",
                "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
                "width": 576,
                "height": 1024
              }
            ]
          },
          "icon": {
            "type": "Image",
            "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
            "width": 576,
            "height": 1024
          },
          "image": [
            {
              "type": "Image",
              "url": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg",
              "width": 576,
              "height": 1024
            }
          ],
          "entityId": "7493556331997071377",
          "album": "Greatest Hits",
          "isOriginal": false,
          "isCopyrighted": false,
          "videoCount": 500000
        }
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/tiktok/search/videos. Authentication and error conventions stay consistent across endpoints. This page shows the path, parameters, response shape, limits, and credit rule for this operation.

Built for

Keyword performance research for content SEO optimization
Trend spotting by search query, date, and engagement
Video content gap analysis for editorial planning

Full reference for this endpoint

const response = await fetch("https://api.konbiniapi.com/v1/tiktok/search/videos", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});

const data = await response.json();

Parameters5

queryrequiredIn · QueryType · stringSearch query
cursorIn · QueryType · stringPagination cursordefault 0
countIn · QueryType · integerNumber of videos to fetch (maximum: 100, actual results may vary)1–100default 50
orderIn · QueryType · stringSort order: relevance (default), most-liked, or date-postedrelevance | most-liked | date-posteddefault relevance
publishedIn · QueryType · stringFilter by publish time: all-time (default), yesterday, this-week, this-month, last-3-months, or last-6-monthsall-time | yesterday | this-week | this-month | last-3-months | last-6-monthsdefault all-time

What you will probably call next.

The TikTok endpoints around this one — the same object at a different depth, or the same kind of read.

All TikTok endpoints Browse every platform

Try it on your own data.

Get a free API key and make this request in minutes. Failed and timed-out requests are automatically refunded.

Get free API key Endpoint reference