TikTok User Stories

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.

Endpoint

GET /v1/tiktok/user/stories

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

Parameters

Provide exactly one of username, user_id, or url.

Response Fields

Example Request

cURL

curl "https://apidirect.io/v1/tiktok/user/stories?username=jamescharles" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

response = requests.get(
    "https://apidirect.io/v1/tiktok/user/stories",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"username": "jamescharles"}
)
print(response.json())

Example Response

{
  "stories": [
    {
      "video_id": "7695841671082216717",
      "title": "",
      "url": "https://www.tiktok.com/@jamescharles/video/7695841671082216717",
      "date": "2026-10-12 17:56:33",
      "date_timestamp": 1791827793,
      "author": "jamescharles",
      "source": "TikTok",
      "domain": "tiktok.com",
      "snippet": "",
      "region": "US",
      "play_count": 55471,
      "likes": 1352,
      "comments": 0,
      "shares": 25,
      "downloads": 0,
      "saves": 0,
      "duration": 7,
      "is_ad": false,
      "is_pinned": false,
      "author_name": "James Charles",
      "author_id": "190068318278651904",
      "author_avatar": "https://p16-common-sign.tiktokcdn-eu.com/.../avatar.jpeg",
      "author_url": "https://www.tiktok.com/@jamescharles",
      "cover": "https://p16-common-sign.tiktokcdn-eu.com/.../cover.jpeg",
      "dynamic_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../dynamic_cover.webp",
      "origin_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../origin_cover.jpeg",
      "video_url": "https://v19.tiktokcdn-eu.com/.../video.mp4",
      "video_url_watermarked": "https://v19.tiktokcdn-eu.com/.../video_wm.mp4",
      "size": 10246341,
      "size_watermarked": 9402354,
      "images": [],
      "music_id": "7695565970584193805",
      "music_title": "original sound - darth.amidalaa",
      "music_author": "darth amidala",
      "music_url": "https://sf16-music.tiktokcdn-eu.com/.../music.mp3",
      "music_cover": "https://p16-common-sign.tiktokcdn-eu.com/.../music_cover.jpeg",
      "music_album": "",
      "music_original": true,
      "music_duration": 7,
      "mentioned_user_ids": []
    }
  ],
  "username": "jamescharles",
  "pages": 1,
  "count": 3
}