📱 TikTok User Story Scraper

Collect TikTok Stories for a given user: each run returns story items with playback URLs, covers, music, engagement stats, and author fields. Results are written to the dataset as structured JSON, with scrapedAt on every record.

✨ Key Features

• 📥 Fetch a user’s active stories via unique_id (handle) or user_id
• 📊 Per-item metadata including duration, region, titles/descriptions where available
• 🔗 Direct links for video playback (with and without watermark), covers, and music
• 📈 Automatic pagination until maxResults is reached or there are no more pages
• ⏱️ Short delay between requests to reduce rate pressure
• 📋 Clean JSON rows ready for pipelines or exports

💪 Why Use This Actor?

• Focused: Built for the user-story endpoint, not the general post feed
• Flexible: Identify the account by handle or internal user id
• Bounded: You set the maximum number of items to collect
• Traceable: Each row includes scrapedAt (ISO time)

🎯 Good For

• 📊 Social and content analysts
• 🎯 Social media and community managers
• 📱 Influencer and brand teams
• 📈 Market and competitor research
• 🎬 Creators tracking story performance
• 🔬 Trend and product researchers

📈 Example Use Cases

1. Monitoring: Snapshot what a public account is posting to Stories
2. Research: Compare story cadence and engagement-style fields across accounts
3. Archiving: Pull playable URLs and covers for compliance or internal review workflows
4. Integration: Feed structured story rows into your own database or BI tools

📝 Input

Parameter	Required	Description
unique_id	One of unique_id / user_id	Handle, with or without @
user_id	One of unique_id / user_id	TikTok user id string
maxResults	No	Max story items to collect (default: 30)

Input example

{
  "unique_id": "@isi.cos",
  "maxResults": 40
}

Output example

Each dataset item mirrors the API fields for a story clip, plus scrapedAt:

[
  {
    "aweme_id": "v24044gl0000d6vrm7nog65mkalu8v60",
    "video_id": "7620014841440341270",
    "region": "AT",
    "title": "",
    "content_desc": [],
    "cover": "https://p16-pu-sign-no.tiktokcdn-eu.com/...",
    "duration": 15,
    "play": "https://v31-jp.tiktokcdn.com/...",
    "wmplay": "https://v31-jp.tiktokcdn.com/...",
    "music_info": {
      "id": "7595742035458444062",
      "title": "original sound - cartoonnasx",
      "author": "Cartoonnasx",
      "original": true,
      "duration": 22
    },
    "play_count": 5266,
    "digg_count": 549,
    "comment_count": 0,
    "share_count": 30,
    "author": {
      "id": "7128593328456041478",
      "unique_id": "isi.cos",
      "nickname": "isi💕"
    },
    "scrapedAt": "2026-03-23T06:40:35.280Z"
  }
]