🎬 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 json { "uniqueIds": ["hbomax"] } ### 2️⃣ Multiple Users Extraction json { "uniqueIds": ["charlidamelio", "khaby.lame"] } ### 3️⃣ Larger Batch Example json { "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 json { "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