Get user stories — TikTok API

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.

Get free API key View the docs

GET/v1/tiktok/users/{username}/stories1 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/users/khaby.lame/stories",
    "totalItems": 1309,
    "cursor": null,
    "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",
            "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
        }
      }
    ]
  }
}

Make the request.

One authenticated GET to /v1/tiktok/users/{username}/stories. 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

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

Full reference for this endpoint

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();

Parameters3

usernamerequiredIn · PathType · stringTikTok username (with or without @ symbol)
countIn · QueryType · integerNumber of stories to fetch (maximum: 35)1–35default 4
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