🎬 TikTok Story Viewer

View and download TikTok stories from any user instantly. Extract story videos, covers, music information, engagement metrics, and comprehensive metadata. Perfect for social media monitoring, content analysis, competitive research, and influencer marketing!

📋 Table of Contents

• 🚀 Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 🎨 Story Data Extracted
• 📈 Performance & Reliability
• 💡 Best Practices
• ❓ FAQ
• 🛠️ Troubleshooting
• 📞 Support

🚀 Features

🎬 Complete Story Extraction

• ✅ No Login Required - View TikTok stories without an account
• ✅ Instant Access - Get story data in real-time
• ✅ Batch Processing - Extract stories from multiple users efficiently
• ✅ Real-Time Data - Access the latest active stories instantly
• ✅ High-Quality Videos - Download stories in original quality

📊 Comprehensive Data

• ✅ Video Downloads - Direct download links for story videos
• ✅ Multiple Covers - Cover, dynamic cover, and origin cover URLs
• ✅ Music Information - Complete audio/music metadata extraction
• ✅ Engagement Metrics - Views, likes, comments, shares, and more
• ✅ Author Details - Complete user profile information

🎵 Advanced Features

• ✅ Music Extraction - Get music title, author, play URL, and cover
• ✅ Original Sound Detection - Identify original vs. library music
• ✅ Engagement Analytics - Track performance metrics
• ✅ Commerce Info - Detect ads and branded content
• ✅ Regional Data - Access region-specific information

🎯 Use Cases

Use Case	Description	Benefits
📊 Social Media Monitoring	Track TikTok stories and campaigns	Monitor brand activities, analyze content strategies
🎯 Influencer Marketing	Analyze influencer story performance	Identify collaboration opportunities, track ROI
📢 Brand Tracking	Monitor brand presence in stories	Track brand visibility, measure campaign reach
📝 Content Archiving	Save stories for future reference	Create content libraries, preserve viral moments
🔍 Competitive Intelligence	Study competitor story strategies	Benchmark performance, discover trends
📈 Marketing Analytics	Analyze story engagement and timing	Optimize posting schedules, improve strategy
🎓 Research & Analysis	Study TikTok user behavior	Collect data for academic or market research
💼 Agency Services	Provide story monitoring for clients	Deliver comprehensive social media reports
🎵 Music Trend Analysis	Track popular music in stories	Identify trending sounds, analyze music usage
📺 Content Creation	Research successful story formats	Improve content quality, boost engagement

⚡ Quick Start

1️⃣ Basic Story Extraction

{
  "uniqueIds": ["hbomax"]
}

2️⃣ Multiple Users Extraction

{
  "uniqueIds": ["charlidamelio", "khaby.lame"]
}

3️⃣ Larger Batch Example

{
  "uniqueIds": ["user1", "user2", "user3", "user4"]
}

📊 Input Parameters

Configuration Options

Parameter	Type	Required	Default	Description
uniqueIds	Array	✅	["hbomax"]	TikTok usernames to extract stories from

📝 Parameter Details

uniqueIds (Required)

• Array of TikTok usernames (unique_id)
• Can include @ symbol or just the username
• Examples: ["hbomax"], ["charlidamelio", "khaby.lame"]
• Supports batch processing (1-50 users)
• Duplicates are automatically removed
• Case-insensitive

📤 Output Format

🎬 Story Data Structure

{
  "source": "tiktok",
  "aweme_id": "v12044gd0000d4jpe6nog65in4ah277g",
  "video_id": "7577190937529486606",
  "unique_id": "hbomax",
  "region": "US",
  "title": "",
  "cover_url": "https://p16-sign.tiktokcdn-us.com/...",
  "dynamic_cover_url": "https://p16-sign.tiktokcdn-us.com/...",
  "origin_cover_url": "https://p16-sign.tiktokcdn-us.com/...",
  "video_url": "https://v16m.tiktokcdn.com/...",
  "video_url_watermark": "https://v16m.tiktokcdn.com/...",
  "duration": 21,
  "size": 2537195,
  "watermark_size": 2583528,
  "create_time": 1764202271,
  "create_time_date": "2025-11-27T15:17:51.000Z",
  "is_ad": false,
  "is_top": 0,
  "engagement": {
    "play_count": 7071,
    "digg_count": 298,
    "comment_count": 0,
    "share_count": 4,
    "download_count": 0,
    "collect_count": 0
  },
  "music_info": {
    "id": "7577190172110949133",
    "title": "original sound - hbomax",
    "play_url": "https://sf16-ies-music-va.tiktokcdn.com/...",
    "cover_url": "https://p16-sign-va.tiktokcdn.com/...",
    "author": "HBO Max",
    "is_original": true,
    "duration": 21,
    "album": ""
  },
  "music_url": "https://sf16-ies-music-va.tiktokcdn.com/...",
  "author_info": {
    "id": "6803724582765200389",
    "unique_id": "hbomax",
    "nickname": "HBO Max",
    "avatar_url": "https://p16-sign-va.tiktokcdn.com/..."
  },
  "commerce_info": {
    "adv_promotable": false,
    "auction_ad_invited": false,
    "branded_content_type": 0
  }
}

🎨 Story Data Extracted

🎬 Video Content

Element	Description	Details
Video URL	Direct download link (no watermark)	High-quality MP4 format
Watermark Video	Video with TikTok watermark	Alternative download option
Duration	Video length in seconds	Precise timing information
File Size	Video file size in bytes	Both versions included

🖼️ Cover Images

Element	Description	Use Case
Cover URL	Standard story cover image	Thumbnail previews
Dynamic Cover	AI-generated dynamic cover	Enhanced visuals
Origin Cover	Original cover image	High-quality thumbnails

🎵 Music & Audio

Element	Data Extracted	Details
Music Title	Song or sound name	Full track information
Music Author	Artist or creator name	Original creator details
Play URL	Direct audio download link	MP3 format
Cover Image	Music cover artwork	Album art or profile pic
Original Sound	Boolean flag	Identifies original vs. library music
Duration	Audio length in seconds	Precise timing

📈 Engagement Metrics

Metric	Description	Use Case
Play Count	Total video views	Measure reach and visibility
Digg Count	Total likes (hearts)	Gauge audience appreciation
Comment Count	Number of comments	Assess engagement level
Share Count	Times shared	Track virality potential
Download Count	Download statistics	Monitor content saving
Collect Count	Times added to favorites	Measure content value

📈 Performance & Reliability

⚡ Speed & Efficiency

Metric	Performance	Details
Response Time	1-5 seconds	Per user request
Story Extraction	Real-time	All active stories
Batch Processing	10 stories/batch	Efficient data handling
Concurrent Users	Up to 50	Batch processing support

🔄 Reliability Features

• ✅ Auto-Retry Logic - Handles temporary failures with exponential backoff
• ✅ API Key Rotation - Multiple keys for high availability
• ✅ Error Recovery - Comprehensive error handling and reporting
• ✅ Rate Limit Protection - Smart throttling to prevent blocks
• ✅ Data Validation - Ensures output quality and completeness

💡 Best Practices

✅ Recommended Usage

1. Leverage Full Data - Actor always returns author, music, and engagement data when available
2. Use Batch Processing - Process multiple users (up to 50) efficiently
3. Monitor Regularly - Set up scheduled runs for continuous tracking
4. Download Immediately - Save videos and music files as URLs may expire
5. Track Engagement - Monitor performance metrics over time
6. Analyze Music Trends - Identify trending sounds and original content

⚠️ Important Notes

• TikTok stories are temporary and may expire
• Media URLs (video, music, covers) may expire after some time
• Download and save content immediately if archiving is needed
• Users without active stories return empty results
• Engagement metrics are snapshots at extraction time

❓ FAQ

Q: Do I need a TikTok account to use this?

A: No! This actor works without requiring any TikTok login or authentication. Simply provide the username.

Q: What is a unique_id?

A: The unique_id is the TikTok username (e.g., "hbomax", "charlidamelio"). You can find it in the user's profile URL or @handle.

Q: How long are TikTok stories available?

A: TikTok stories are temporary content. This actor extracts currently active stories from users.

Q: What if a user has no stories?

A: The actor will complete successfully but return an empty result with a message indicating no stories were found.

Q: Are the download links permanent?

A: No, TikTok media URLs (videos, music, covers) may expire after some time. Download and save content immediately if needed.

Q: Can I extract stories from multiple users?

A: Yes! You can provide up to 50 usernames in the uniqueIds array for efficient batch processing.

Q: What's the difference between video_url and video_url_watermark?

A: video_url provides the video without TikTok watermark, while video_url_watermark includes the TikTok branding.

Q: Can I track music trends with this actor?

A: Yes! The actor automatically includes full music metadata (title, author, play URL, cover, duration, original sound flag) whenever it is available.

Q: What engagement metrics are available?

A: The output includes: play count (views), digg count (likes), comments, shares, downloads, and collects for each story when this data is available.

Q: Does this work for regular TikTok videos?

A: This actor is specifically designed for TikTok Stories. For regular TikTok videos, you would need a different scraper.

Q: Is this legal and compliant?

A: This tool accesses publicly available data. Users must comply with TikTok's Terms of Service and applicable laws. Use responsibly and ethically.

Q: How often can I run this actor?

A: You can run it as often as needed. The actor includes automatic retry logic and API key rotation for reliability.

Q: What regions are supported?

A: The actor works globally and includes region information in the output data.

🔍 Debug Tips

1. Verify Username - Check the unique_id exists on TikTok (e.g., @hbomax)
2. Check Story Availability - Ensure the user has active stories
3. Review Logs - Check actor run logs for detailed error messages
4. Test with Known Accounts - Try with verified accounts like "hbomax" or "tiktok"
5. Check Input Format - Ensure uniqueIds is an array: ["username1", "username2"]
6. Remove @ Symbol - The actor automatically removes @ if included

📞 Support

🆘 Need Help?

• 📧 Issues - Report bugs and request features on the actor page
• 📖 Documentation - Complete guides and examples in this README
• 🎯 Best Practices - Follow the recommendations above for optimal usage
• 💬 Community - Share your use cases and get help from other users

---

Related Actors 🤝

Looking for more TikTok data extraction tools? Check out these related actors:

• TikTok Trending Videos Scraper
• TikTok Media Downloader
• TikTok Comments Scraper
• TikTok Search Videos Scraper
• TikTok Search Profile Scraper
• TikTok Profile Details Scraper

---

🏷️ Keywords & Tags

tiktok story viewer, tiktok story downloader, tiktok stories scraper, download tiktok stories, tiktok story api, tiktok story extractor, tiktok story analytics, tiktok story monitoring, tiktok story archiver, tiktok story saver, tiktok story backup, tiktok story data extraction, tiktok story metadata, tiktok music extractor, tiktok engagement metrics, tiktok story viewer without login, tiktok story viewer online, tiktok story downloader apify, tiktok story scraper apify actor, tiktok social media monitoring, tiktok competitor analysis, tiktok influencer research, tiktok content analysis, tiktok story automation, tiktok story tracking, tiktok story research tool, tiktok story batch download, tiktok api scraper, tiktok story viewer tool, tiktok story data scraper, tiktok story content extractor, tiktok music scraper, tiktok engagement tracker, tiktok analytics tool, tiktok data extraction, tiktok scraper, tiktok downloader, tiktok story collector, tiktok trend analysis, tiktok marketing tool, tiktok social media tool

---

🚀 Get Started Now

Ready to extract TikTok stories with comprehensive data?

1. Click "Try for free" to test the actor
2. Enter TikTok Usernames
3. Get complete story data with videos, music, and engagement metrics instantly

⭐ If this actor helps your workflow, please give it a star!

---

Built with ❤️ using Apify Platform | 🎬 TikTok Story Viewer v1.0