Get tag videos

Returns videos associated with a hashtag or challenge. The tag name is resolved to an internal ID automatically.

GET /v1/tiktok/tags/{tagName}

Get tag videos

cURL

curl --request GET \
  --url https://api.konbiniapi.com/v1/tiktok/tags/{tagName} \
  --header 'Authorization: Bearer <token>'

200

{
  "data": {
    "@context": [
      "https://www.w3.org/ns/activitystreams#",
      "https://konbiniapi.com/ns/social#"
    ],
    "type": "OrderedCollectionPage",
    "partOf": "https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/videos",
    "totalItems": 1309,
    "itemCount": 30,
    "orderedItems": [
      {
        "type": "Video",
        "id": "https://www.tiktok.com/@khaby.lame/video/7611615657754381599",
        "url": "https://www.tiktok.com/@khaby.lame/video/7611615657754381599",
        "internalId": "7611615657754381599",
        "published": "2026-02-27T18:36:42.000Z",
        "viewCount": 42600000,
        "likeCount": 2800000,
        "commentCount": 29200,
        "repostCount": 0,
        "shareCount": 157700,
        "saveCount": 153238,
        "attributedTo": {
          "type": "Person",
          "id": "https://www.tiktok.com/@khaby.lame",
          "url": "https://www.tiktok.com/@khaby.lame",
          "isPrivate": false,
          "isVerified": true,
          "userId": "127905465618821121",
          "internalId": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
          "name": "Khabane lame",
          "preferredUsername": "khaby.lame",
          "summary": "Just a guy who reacts",
          "attachment": [
            {
              "type": "Link",
              "href": "https://linktr.ee/khaby.lame"
            }
          ],
          "published": "2020-03-15T00:00:00.000Z",
          "isLive": false,
          "hasLikes": true,
          "hasPlaylists": true,
          "followerCount": 160300000,
          "followingCount": 85,
          "likeCount": 2600000000,
          "videoCount": 1309,
          "icon": {
            "type": "Image",
            "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
            "width": 576,
            "height": 1024
          },
          "image": [
            {
              "type": "Image",
              "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
              "width": 576,
              "height": 1024
            }
          ]
        },
        "summary": "When you realize there is a simpler way #learnfromkhaby",
        "duration": 23,
        "tag": [
          {
            "type": "Tag",
            "name": "learnfromkhaby",
            "href": "https://www.tiktok.com/tag/learnfromkhaby",
            "id": "https://www.tiktok.com/tag/learnfromkhaby",
            "internalId": "1697657584273413"
          }
        ],
        "attachment": [
          {
            "type": "Video",
            "name": "normal_540_0",
            "url": [
              "https://v16-webapp.tiktok.com/video/tos/useast2a/..."
            ],
            "mediaType": "video/mp4",
            "codec": "h264",
            "width": 576,
            "height": 1024,
            "bitrate": 1101943,
            "headers": {
              "Cookie": "tt_chain_token=sTA6PK6OnvhW7YemGVwMig==",
              "Referer": "https://www.tiktok.com/"
            }
          }
        ],
        "image": {
          "type": "Image",
          "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
          "width": 576,
          "height": 1024
        },
        "preview": {
          "type": "Image",
          "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
          "width": 576,
          "height": 1024
        },
        "audio": {
          "type": "Audio",
          "url": "https://sf16-ies-music.tiktokcdn.com/obj/tos-alisg-v/123456",
          "name": "original sound",
          "duration": 23,
          "id": "https://www.tiktok.com/music/original-sound-7611615657754381599",
          "mediaType": "audio/mpeg",
          "album": "Greatest Hits",
          "videoCount": 500000,
          "attributedTo": {
            "type": "Person",
            "id": "https://www.tiktok.com/@khaby.lame",
            "url": "https://www.tiktok.com/@khaby.lame",
            "isPrivate": false,
            "isVerified": true,
            "userId": "127905465618821121",
            "internalId": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
            "name": "Khabane lame",
            "preferredUsername": "khaby.lame",
            "summary": "Just a guy who reacts",
            "attachment": [
              {
                "type": "Link",
                "href": "https://linktr.ee/khaby.lame"
              }
            ],
            "published": "2020-03-15T00:00:00.000Z",
            "isLive": false,
            "hasLikes": true,
            "hasPlaylists": true,
            "followerCount": 160300000,
            "followingCount": 85,
            "likeCount": 2600000000,
            "videoCount": 1309,
            "icon": {
              "type": "Image",
              "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
              "width": 576,
              "height": 1024
            },
            "image": [
              {
                "type": "Image",
                "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
                "width": 576,
                "height": 1024
              }
            ]
          },
          "icon": {
            "type": "Image",
            "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
            "width": 576,
            "height": 1024
          },
          "image": [
            {
              "type": "Image",
              "url": "https://p16-sign.tiktokcdn-us.com/tos-avt/123456~c5_100x100.jpeg",
              "width": 576,
              "height": 1024
            }
          ]
        }
      }
    ],
    "cursor": "0",
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/videos?cursor=1772217402000&count=30"
  }
}

Authorizations

Authorization · string · header · required

Send your API key in the Authorization header as a Bearer token. Example: Authorization: Bearer <your-api-key>

Path Parameters

tagName · string · required

Tag name

Query Parameters

count · integer · default: 30

Number of videos to fetch (maximum: 30)

Required range: 1 <= x <= 30

cursor · string · default: 0

Pagination cursor

Response

200

application/json

Returns the tag videos

data · object · required

Show child attributes