TikTok
Story
List an account’s current TikTok stories.
Endpoint
GET
/s/tiktok/storiesSend 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
| Name | Description |
|---|---|
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
- An account with no active stories returns an empty items list.
- TikTok often requires a signed-in session for stories. When it refuses, the API answers 502 and the request is not billed.
- Media URLs are signed by the platform and expire after a few hours. Download the files promptly instead of storing the links.