---
title: "TikTok User Stories"
method: GET
path: "/v1/tiktok/user/stories"
tags: ["TikTok"]
---

# TikTok User Stories

`GET /v1/tiktok/user/stories`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/tiktok/user/stories`
- Auth: API key in header `X-API-Key`

Get a user's currently live stories (the 24-hour posts shown on their profile) by username, numeric user ID, or profile URL. Returns the same fields as User Videos for each story. A user with no live stories returns an empty list. Supports fetching multiple pages in a single API call (billed per page).

**Price:** $0.006 per page. **Free tier:** 50 requests/month.

## Query parameters

- `username` string
- `user_id` string
- `url` string
- `pages` integer
- `get_sentiment` boolean

## Response `200`

Successful response

- TiktokUserStoriesResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `stories` object[], nullable
    - `video_id` string, nullable
    - `title` string, nullable
    - `url` string, nullable
    - `date` string, nullable
    - `date_timestamp` number, nullable
    - `author` string, nullable
    - `source` string, nullable
    - `domain` string, nullable
    - `snippet` string, nullable
    - `region` string, nullable
    - `play_count` number, nullable
    - `likes` number, nullable
    - `comments` number, nullable
    - `shares` number, nullable
    - `downloads` number, nullable
    - `saves` number, nullable
    - `duration` number, nullable
    - `is_ad` boolean, nullable
    - `is_pinned` boolean, nullable
    - `author_name` string, nullable
    - `author_id` string, nullable
    - `author_avatar` string, nullable
    - `author_url` string, nullable
    - `cover` string, nullable
    - `dynamic_cover` string, nullable
    - `origin_cover` string, nullable
    - `video_url` string, nullable
    - `video_url_watermarked` string, nullable
    - `size` number, nullable
    - `size_watermarked` number, nullable
    - `images` unknown[], nullable
      - unknown
    - `music_id` string, nullable
    - `music_title` string, nullable
    - `music_author` string, nullable
    - `music_url` string, nullable
    - `music_cover` string, nullable
    - `music_album` string, nullable
    - `music_original` boolean, nullable
    - `music_duration` number, nullable
    - `mentioned_user_ids` unknown[], nullable
      - unknown
  - `username` string, nullable
  - `pages` number, nullable
  - `count` number, nullable

## Other responses

- `400`: Bad request: missing or invalid parameters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `404`: TikTok user not found
- `429`: Rate limit exceeded or too many concurrent requests
- `500`: Internal server error
- `502`: Temporary failure retrieving TikTok data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)