TikTok

Story

List an account’s current TikTok stories.

Endpoint

GET
/s/tiktok/stories

Send your API key in the X-API-Key header. tiktok is the usual service slug; use the one shown on your subscription if it differs.

Query parameters

NameDescription
usernamerequired
Account name, with or without the leading @.Example: scout2015

Example request

curl '/s/tiktok/stories?username=scout2015' \
  -H 'X-API-Key: YOUR_API_KEY'

Example response

The result is in data. Fields the platform didn't report are left out. Field reference: response shapes.

{
  "data": {
    "items": [
      {
        "platform": "tiktok",
        "id": "7312000000000000001",
        "type": "story",
        "createdAt": "2026-11-14T08:00:00Z",
        "expiresAt": "2026-11-15T08:00:00Z",
        "author": {
          "id": "6743219038927391749",
          "username": "scout2015",
          "name": "Scout & Suki",
          "avatar": "https://cdn.example/avatar.jpg",
          "verified": false
        },
        "media": [
          {
            "type": "video",
            "url": "https://v16.tiktokcdn.example/story.mp4",
            "thumbnail": "https://p16.tiktokcdn.example/story.jpeg",
            "duration": 9
          }
        ],
        "stats": {}
      }
    ],
    "hasMore": false
  }
}

Notes