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. Supports fetching multiple pages in a single API call (billed per page).
Price: $0.006 per page. Free tier: 50 requests/month.
Request
- Base URL: https://apidirect.io
- URL: https://apidirect.io/v1/tiktok/user/stories
- Auth: API key in header X-API-Key
Query parameters
TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url.
Numeric TikTok user ID, as returned by Search Users or User Profile. Provide exactly one of username, user_id, or url.
TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url.
Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 30 stories.
Set to true to add AI emotion analysis to each item. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any item that cannot be scored returns sentiment: null.
Response
Successful response
Changes
No recorded changes to this operation across all 1 revision of this API.