Get videos with tag — TikTok API

Returns TikTok videos associated with a hashtag or challenge. The tag name is resolved to an internal ID automatically. Includes video details and engagement counts.

Get free API key View the docs

GET/v1/tiktok/tags/{tagName}1 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/tags/learnfromkhaby/videos",
    "totalItems": 1309,
    "cursor": null,
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/tiktok/tags/learnfromkhaby/videos?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/tags/{tagName}. 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

Hashtag campaign performance monitoring and reporting
Emerging trend discovery through tag volume analysis
Competitive hashtag benchmarking for content strategy

Full reference for this endpoint

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

const data = await response.json();

Parameters3

tagNamerequiredIn · PathType · stringTag name
countIn · QueryType · integerNumber of videos to fetch (maximum: 30)1–30default 30
cursorIn · QueryType · stringPagination cursordefault 0

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