TikTok Story Viewer

🎬 TikTok Story Viewer for active public stories

TikTok Story Viewer exports currently active public stories from TikTok usernames, @handles, or profile URLs. Add profiles such as hbomax, @tiktok, or https://www.tiktok.com/@jasonderulo, then get one clean dataset row per active story with video links, cover images, timestamps, engagement stats, music metadata, author details, source identifiers, and scrape timestamps.

Use this TikTok story viewer when you need a repeatable way to check public TikTok stories for brand monitoring, creator research, social media reporting, content review, or archiving workflows. The Actor is focused on public profile stories only. You do not need to provide TikTok cookies, a TikTok login, or a TikTok API key.

For a useful first run, keep the prefilled profile set and default limits. TikTok stories are temporary, so a zero-row run usually means the submitted profiles have no active public stories at that moment.

✅ What this Actor does

• Accepts TikTok usernames, @handles, and public profile URLs.
• Checks active public stories for each submitted profile.
• Saves one dataset row per active story.
• Adds video URLs, watermarked video URLs when available, cover images, and duration.
• Adds story IDs, video IDs, source profile URLs, story URLs when they can be built, and scrape timestamps.
• Adds visible engagement stats such as views, likes, comments, shares, downloads, and collects when TikTok exposes them.
• Adds music metadata such as sound title, author, audio URL, cover URL, duration, and original-sound flag when available.
• Adds author details such as TikTok user ID, username, display name, and avatar URL.
• Skips profiles that are private, unavailable, unsupported, or without active public stories without saving placeholder rows.

This Actor does not discover profiles, scrape regular TikTok videos, scrape comments, search TikTok, monitor hashtags, collect followers, or download binary files into storage. It returns the public story data and media URLs TikTok exposes during the run.

📦 Data you can export

Each output row represents one active TikTok story. Core fields include:

• inputIndex and input
• profileUsername and profileUrl
• authorId, authorUsername, authorName, and authorAvatarUrl
• storyId, videoId, and storyUrl
• createdAt, createdTimestamp, durationSeconds, and region
• videoUrl, watermarkedVideoUrl, coverUrl, dynamicCoverUrl, and originCoverUrl
• playCount, likeCount, commentCount, shareCount, downloadCount, and collectCount
• musicId, musicTitle, musicAuthor, musicUrl, musicCoverUrl, musicDurationSeconds, and isOriginalSound
• engagement, music, media, and commerce objects for structured workflows
• scrapedAt

You can open the dataset in Apify, export it as JSON, CSV, Excel, XML, RSS, or HTML, call it through the Apify API, schedule repeat checks, or send rows to webhooks and integrations.

🚀 How to run

1. Add one or more TikTok profiles in TikTok profiles.
2. Use usernames such as hbomax, @handles such as @tiktok, or full profile URLs such as https://www.tiktok.com/@jasonderulo.
3. Keep Profile limit small for a first run, or raise it for a larger batch.
4. Leave Story limit per profile at 0 to save all currently active stories, or set a number to cap each profile.
5. Choose Story order if you need newest-first, oldest-first, or TikTok's profile order.
6. Start the Actor and open the dataset.

Stories expire quickly. If a profile has no active public story when the Actor checks it, no row is saved for that profile.

🔧 Input

Field	What to enter
targets	TikTok usernames, @handles, or public profile URLs.
maxProfiles	Maximum number of profiles to check from your target list. Default is 19.
maxStoriesPerProfile	Maximum active stories to save for each profile. 0 means all active stories found.
sortStories	Output order for stories from each profile: newest, oldest, or profileOrder.

Example input:

{
	"targets": ["hbomax", "@tiktok", "https://www.tiktok.com/@jasonderulo"],
	"maxProfiles": 3,
	"maxStoriesPerProfile": 0,
	"sortStories": "newest"
}

📄 Output example

{
	"inputIndex": 1,
	"input": "hbomax",
	"profileUsername": "hbomax",
	"profileUrl": "https://www.tiktok.com/@hbomax",
	"authorId": "6803724582765200389",
	"authorUsername": "hbomax",
	"authorName": "HBO Max",
	"storyId": "7645112817745480991",
	"videoId": "7645112817745480991",
	"storyUrl": "https://www.tiktok.com/@hbomax/video/7645112817745480991",
	"createdAt": "2026-05-29T01:02:27.000Z",
	"durationSeconds": 14,
	"videoUrl": "https://v16-webapp-prime.us.tiktok.com/...",
	"coverUrl": "https://p16-common-sign.tiktokcdn-us.com/...",
	"playCount": 12302,
	"likeCount": 467,
	"commentCount": 0,
	"shareCount": 7,
	"musicTitle": "original sound - Game of Thrones",
	"musicAuthor": "Game of Thrones",
	"isOriginalSound": true,
	"scrapedAt": "2026-05-29T19:53:01.726Z"
}

Some fields can be null when TikTok does not expose that value for a story.

💸 Pricing

This Actor uses pay-per-event pricing. You are charged for each active TikTok story saved to the dataset. Profiles with no active public stories do not create dataset rows.

The local pricing artifact sets the primary Story charge at $0.018 on the FREE tier and $0.0045 on BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND tiers. The live Pricing tab is the source of truth once the Actor is published.

⚠️ Limits and caveats

• TikTok stories are temporary and can disappear between runs.
• Media URLs may expire, so save important media soon after export.
• Private, deleted, unavailable, or restricted profiles are skipped.
• The Actor works with public profile stories, not regular profile videos or TikTok search.
• Output depends on what TikTok exposes publicly at run time.

❓ FAQ

🔐 Do I need TikTok cookies or a login?

No. The Actor is designed for public TikTok story data and does not ask you for cookies, login credentials, or an API key.

🔎 Why did my run return zero rows?

Most often, the submitted profiles had no active public stories when the Actor checked them. TikTok stories are temporary, so try another public profile or run again later.

📥 Does this download the video files?

No. It exports TikTok media URLs and metadata. If you need saved media files from regular TikTok video URLs, use TikTok Video Downloader.

🕒 Can I run this on a schedule?

Yes. You can schedule the Actor on Apify to check the same profiles repeatedly and export each run's dataset through the API, webhooks, or integrations.

📝 Changelog

• 0.1: Initial release with active public story exports, structured story metadata, and a useful default profile set.
• 0.0: Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Other actors

• TikTok Video Downloader ↗ - download media files from known public TikTok video URLs.
• TikTok Transcript Scraper ↗ - extract transcripts, captions, subtitles, and metadata from public TikTok videos.
• TikTok Keywords Discovery Tool ↗ - collect TikTok autocomplete keyword suggestions for content planning.
• Instagram Downloader API ↗ - export direct media links from public Instagram posts and reels.
• YouTube Channel Scraper ↗ - export public YouTube channel profiles and recent video rows.

Made with ❤️ by Maxime Dupré