API referenceTikTok
TikTok user stories
A creator's currently-live stories, which expire after 24 hours.
The platform keys this on the numeric user_id; passing unique_id instead costs one extra resolve call. An empty posts list means no live story right now.
Deliberately takes no count: the story surface returns a fixed-size page
and ignores every page-size value sent to it (verified live), so accepting
a knob that provably does nothing would be dishonest. Page with cursor.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/tiktok-user-stories-v4" \ -H "Content-Type: application/json" \ -d '{ "user_id": "107955", "cursor": "0" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "aweme_list": [], "cursor": null, "has_more": false, "unique_id": null, "user_id": "107955" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "tiktok-user-stories-v4", "billable": true, "duration_ms": 737 }}