TikTok User Stories Scraper

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).

Features

• Real-time TikTok data — results are fetched live at run time, never cached or stale
• No login, cookies, or proxy configuration needed — just provide the input and run
• Each result is pushed as a separate dataset item, exportable as JSON, CSV, or Excel
• Fast: a typical run finishes in seconds

Input

Field	Type	Required	Description
username	string	no	TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url.
user_id	string	no	Numeric TikTok user ID, as returned by Search Users or User Profile. Provide exactly one of username, user_id, or url.
url	string	no	TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url.
pages	integer	no	Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 30 stories.

Pricing

This Actor is billed per page of results — $0.006 per page.

• Results come in pages. Use the pages input to choose how many pages to fetch (1–1000); more pages means more results.
• You pay $0.006 for each page you fetch, so pages: 3 costs $0.018 and pages: 1 costs $0.006.
• You’re only charged when a run succeeds, or when it fails because what you asked for was looked up and doesn’t exist, is private, or isn’t valid: that costs one page ($0.006). Other failed runs are free.

Example output

{
  "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": []
}

About

Maintained by Data Direct — a small suite of fast, reliable TikTok and web-data scrapers. Each actor returns clean, structured results with no login, cookies, or proxy setup required. Have a question or a custom data need? Open an issue on this actor.