Get user stories from TikTok with KonbiniAPI

Returns a paginated list of active stories for a TikTok user. Stories expire after 24 hours and include both images and videos with engagement data.

This API endpoint returns a paginated list of active stories for a TikTok user. Stories expire after 24 hours and include both images and videos with engagement data.

Perfect for

Ephemeral content monitoring for real-time brand tracking
Creator activity frequency and posting cadence analysis
Story engagement benchmarking for influencer reporting

Get your API key View Full API Reference

See other TikTok endpoints

1. Make the request

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

const data = await response.json();

2. Get clean JSON

Response (200 OK)

{
  "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/stories",
    "totalItems": 1309,
    "cursor": "0",
    "nextCursor": "1772217402000",
    "next": "https://api.konbiniapi.com/v1/tiktok/users/khaby.lame/stories?cursor=1772217402000&count=30",
    "itemCount": 30,
    "orderedItems": [
      {
        "type": "Video",
        "id": "https://www.tiktok.com/@khaby.lame/video/7600000000000000000",
        "url": "https://www.tiktok.com/@khaby.lame/video/7600000000000000000",
        "entityId": "7600000000000000000",
        "content": "When you realize there is a simpler way #learnfromkhaby",
        "published": "2026-02-27T18:36:42.000Z",
        "endTime": "2026-02-28T18: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",
          "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
            }
          ]
        },
        "duration": 23,
        "attachment": [
          {
            "type": "Video",
            "url": [
              "https://v19-webapp.tiktok.com/video/tos/us/tos-useast5-ve-0068c004/story.mp4"
            ],
            "mediaType": "video/mp4",
            "width": 576,
            "height": 1024,
            "name": "normal_540_0",
            "headers": {
              "Cookie": "tt_chain_token=sTA6PK6OnvhW7YemGVwMig==",
              "Referer": "https://www.tiktok.com/"
            },
            "codec": "h264",
            "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
        }
      }
    ]
  }
}