TikTok API
User Story
Get the current story for a TikTok user.
POST
$0.01/call/v1/tiktok/user-storyUsage
const res = await fetch('https://api.yepapi.com/v1/tiktok/user-story', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ unique_id: 'chefmaria' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/tiktok/user-story \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"unique_id": "chefmaria"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
unique_id | string | Yes | TikTok username (without @) | — |
Response
{
"ok": true,
"data": {
"user_id": "6842123456789012345",
"unique_id": "chefmaria",
"stories": [
{
"story_id": "7412345678901234567",
"create_time": 1712678901,
"expire_time": 1712765301,
"video": {
"duration": 15,
"cover": "https://p16-sign.tiktokcdn.com/...",
"play_addr": "https://v16-webapp.tiktok.com/..."
}
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.user_id | string | User's unique numeric identifier |
data.unique_id | string | User's unique handle |
data.stories | object[] | Array of active story objects |
data.stories[].story_id | string | Unique story identifier |
data.stories[].create_time | number | Unix timestamp of when the story was posted |
data.stories[].expire_time | number | Unix timestamp of when the story expires |
data.stories[].video | object | Story media details (duration, cover, play URL) |
Stories are ephemeral and typically expire after 24 hours.