# TikTok Story Viewer (`parsebird/tiktok-story-viewer`) Actor View and download active public TikTok stories by username or profile URL. Get no-watermark and watermarked video links, covers, photo slides, views, likes, sound details, and author info. Export JSON, CSV, Excel. - **URL**: https://apify.com/parsebird/tiktok-story-viewer.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.29 / 1,000 tiktok stories This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### TikTok Story Viewer TikTok Story Viewer lets you see and download active public [TikTok](https://www.tiktok.com/) stories anonymously: add usernames or profile links and get every live story with its video links (without and with watermark), covers, photo slides, views, likes, sound, and author details.
Check up to 500 TikTok profiles per run and get one row per active story with a no-watermark video link, file sizes, covers, engagement counts, and sound info, without logging in or letting the creator know.

ParseBird TikTok Suite   •  Video, story, LIVE & shop data
TikTok Slideshow Downloader
Photo-mode posts as image files 		TikTok Story Viewer
You are here 		TikTok Live Search Scraper
LIVE rooms by keyword 		TikTok Shop Reviews Scraper
Product reviews and ratings
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```text Use Apify Actor parsebird/tiktok-story-viewer to fetch active public TikTok stories. Example with ApifyClient (Python): client.actor("parsebird/tiktok-story-viewer").call(run_input={"targets":["jasonderulo","@wnba","https://www.tiktok.com/@jamescharles"],"maxStoriesPerProfile":10,"sortStories":"newest"}). Inputs: targets array of strings required (1-500 TikTok usernames, @handles, or profile URLs); maxStoriesPerProfile integer optional (empty = all active stories); sortStories "newest" (default), "oldest", or "profileOrder". Stories last 24 hours; profiles with no active story return no row. Output: one row per story with storyId, videoId, profileUsername, createdAt (ISO 8601), durationSeconds, isAd, storyType (video/photo), author{id,username,name,avatarUrl}, media{videoUrl (no watermark, downloadable without cookies from US IPs), watermarkedVideoUrl (session-bound), coverUrl, dynamicCoverUrl, originCoverUrl, sizeBytes, watermarkedSizeBytes, imageUrls}, engagement{playCount,likeCount,commentCount,shareCount,collectCount}, music{id,title,author,playUrl,coverUrl,durationSeconds,isOriginal}. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations. ``` ### What is TikTok Story Viewer? **TikTok Story Viewer** is an anonymous **TikTok story viewer and downloader**. Enter a username such as `jasonderulo`, an @handle such as `@wnba`, or a profile link such as `https://www.tiktok.com/@jamescharles`, and it returns **every active public story** on that profile as structured data, including a **direct video link without watermark** for video stories and the **slide images** for photo stories. You don't need a TikTok account, and the creator can't see your view. The easiest way to try it is to open the actor, keep the prefilled profiles, and click **Start**. TikTok stories disappear **24 hours** after they are posted, so the actor returns whatever is live at the moment it checks. A valid profile with no active story produces no row. ### What can TikTok Story Viewer do? - 🎬 **Get story videos without watermark**: `media.videoUrl` is a direct MP4 link that downloads without TikTok cookies from a US connection. - 💧 **Also get the watermarked version** (`media.watermarkedVideoUrl`) with both file sizes. - 🖼️ **Handle photo stories** with `media.imageUrls` and cover images. - 📊 **See story stats**: views, likes, comments, shares, and saves. - 🎵 **Get sound details**: music ID, title, author, audio link, cover, length, and whether it is an original sound. - 👥 **Check up to 500 profiles per run**, with a per-profile story limit and newest, oldest, or profile order. - ⏱️ **Archive stories automatically** by running on a schedule with [Apify schedules](https://docs.apify.com/platform/schedules), for example every few hours, so no story is missed before it expires. - 🔌 **Connect** results to the [Apify API](https://docs.apify.com/api/v2), webhooks, and [integrations](https://apify.com/integrations) such as Make, Zapier, Google Drive, and Slack. - 📁 **Export** as JSON, CSV, Excel, HTML, or XML. ### What data can you extract from TikTok stories? | Field | Description | |-------|-------------| | `storyId`, `videoId` | TikTok story ID and media ID | | `profileUsername` | Profile the story was checked on | | `createdAt` | Story post time (ISO 8601, UTC) | | `durationSeconds` | Video length (null for photo stories) | | `storyType` | `video` or `photo` | | `isAd` | Whether TikTok marks the story as an ad | | `author.id`, `author.username`, `author.name`, `author.avatarUrl` | Story author | | `media.videoUrl`, `media.sizeBytes` | Direct video link without watermark and its size in bytes | | `media.watermarkedVideoUrl`, `media.watermarkedSizeBytes` | Watermarked video link and its size in bytes | | `media.coverUrl`, `media.dynamicCoverUrl`, `media.originCoverUrl` | Cover, animated cover, and original cover images | | `media.imageUrls` | Slide images of a photo story | | `engagement.playCount`, `likeCount`, `commentCount`, `shareCount`, `collectCount` | Story views, likes, comments, shares, saves | | `music.id`, `title`, `author`, `playUrl`, `coverUrl`, `durationSeconds`, `isOriginal` | Sound used in the story | Values are `null` when TikTok does not provide them. ### How to view TikTok stories anonymously 1. Open [TikTok Story Viewer](https://apify.com/parsebird/tiktok-story-viewer) and click **Try for free** or **Start**. 2. In **TikTok profiles**, add usernames, @handles, or profile links, one per line. 3. Optionally set **Story limit per profile** and **Story order**. 4. Click **Start**. Each profile takes a few seconds. 5. Open the **Output** tab. Click `media.videoUrl` to watch or download a video story without watermark (from a US connection; see the FAQ). 6. Export the results as JSON, CSV, or Excel, or fetch them through the API. ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `targets` | array of strings | **Yes** | — | 1–500 TikTok usernames, @handles, or profile URLs. Repeated profiles are checked once. | | `maxStoriesPerProfile` | integer | No | empty (all) | Maximum active stories saved per profile. The form pre-fills `10`. | | `sortStories` | string | No | `newest` | `newest`, `oldest`, or `profileOrder` (the order TikTok shows them on the profile, oldest first) | | `proxyConfiguration` | object | No | Apify Proxy, US | Network settings; the default works for most runs | ### Input / Output Example input: ```json { "targets": ["hbo", "hbomax", "jamescharles", "tiktok", "wnba", "jasonderulo"], "maxStoriesPerProfile": 10, "sortStories": "newest" } ``` Example video story row: ```json { "storyId": "7690594136067476766", "videoId": "7690594136067476766", "profileUsername": "cleiamazzeo86", "createdAt": "2026-09-28T14:33:33.000Z", "durationSeconds": 25, "isAd": false, "storyType": "video", "author": { "id": "6638285105437048833", "username": "cleiamazzeo86", "name": "Cleia | TikTok Growth Coach", "avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/955ab4070dad46b4507511930c806b1d~tplv-tiktokx-cropcenter:1080:1080.jpeg?..." }, "media": { "videoUrl": "https://www.tiktok.com/aweme/v1/play/?faid=1988&file_id=4297d4cbc2c440659a778bb825f6a137&is_play_url=1&item_id=7690594136067476766&...", "watermarkedVideoUrl": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-pve-0068-tx2/oYfk0fXAEgBE6yAu8xDNVqIZuQDqQ9RznFaE1o/?...", "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oYrPaGdmgAqvdaDI5IeIMkUeyQ1jA2LJV0CR0e~tplv-tiktokx-origin.image?...", "dynamicCoverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oA8ku0qEnXQNuVXqAuCQR9oFRfVSOfEVEDaBAy~tplv-tiktokx-origin.image?...", "originCoverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/okaL0ICkgFjqlUevee5d0gPJVXN9RG50dCIAAI~tplv-tiktokx-origin.image?...", "sizeBytes": 2180058, "watermarkedSizeBytes": 2054492, "imageUrls": [] }, "engagement": { "playCount": 39, "likeCount": 2, "commentCount": 0, "shareCount": 0, "collectCount": 0 }, "music": { "id": "7673242040704961310", "title": "original sound", "author": "Cleia | TikTok Growth Coach", "playUrl": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oAqPBf7MKi0qER1AOA1AiAX8EUEmBAlGBimAKE/?...", "coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/955ab4070dad46b4507511930c806b1d~tplv-tiktokx-cropcenter:1080:1080.jpeg?...", "durationSeconds": 24, "isOriginal": true } } ``` Photo stories use the same shape: `storyType` is `photo`, video links and `durationSeconds` are `null`, and `media.imageUrls` lists the slides. Download results in JSON, CSV, Excel, HTML, or XML. ### Python API example ```python from apify_client import ApifyClient import urllib.request client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("parsebird/tiktok-story-viewer").call(run_input={ "targets": ["jasonderulo", "@wnba"], "sortStories": "newest", }) for story in client.dataset(run["defaultDatasetId"]).iterate_items(): url = story["media"]["videoUrl"] if url: urllib.request.urlretrieve(url, f"{story['storyId']}.mp4") ``` ### JavaScript API example ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('parsebird/tiktok-story-viewer').call({ targets: ['https://www.tiktok.com/@jamescharles', 'wnba'], maxStoriesPerProfile: 5, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((s) => console.log(s.profileUsername, s.storyType, s.engagement.playCount, s.media.videoUrl)); ``` See the [Python client](https://docs.apify.com/api/client/python/) and [JavaScript client](https://docs.apify.com/api/client/js/) docs for more options. ### Use cases - **Story archiving**: schedule runs to save a brand's or creator's stories before they expire. - **Competitor monitoring**: see what competing brands post in stories and how many views they get. - **Influencer research**: check how often creators post stories and how they perform. - **Content collection**: download story videos without watermark for your own content review. - **Sound tracking**: see which songs and sounds appear in stories. ### How it works 1. The actor turns each username, @handle, or profile link into a username and skips repeats. 2. It loads the public profile, then reads all active stories page by page. 3. It sorts stories, applies the per-profile limit, and reads the watermarked file size. 4. It pushes one row per story and logs profiles with no active story or that could not be loaded. ### How much does it cost to view TikTok stories? **What is the price per TikTok story?** The actor uses pay-per-event pricing: you pay per story row saved, and platform usage is included. | Event | Free plan | Bronze | Silver | Gold | |-------|-----------|--------|--------|------| | `story-scraped` | $0.00299 (**$2.99 / 1,000**) | $0.00269 (**$2.69 / 1,000**) | $0.00249 (**$2.49 / 1,000**) | $0.00229 (**$2.29 / 1,000**) | One `story-scraped` event is one story saved to the dataset. Profiles with no active story and profiles that fail to load are not charged. 1,000 stories cost $2.99 on the Free plan. Apify's free plan includes monthly platform credits you can use to try the actor. ### Is it legal to view TikTok stories with a scraper? **Is scraping TikTok stories legal?** The actor only reads stories that TikTok shows publicly without login. Scraping public data is generally legal in many jurisdictions, but story videos are protected by copyright and may include personal data. Use the data responsibly, respect creators' rights and [TikTok's Terms of Service](https://www.tiktok.com/legal/page/us/terms-of-service/en), and consult your lawyer if unsure. Read more in Apify's guide: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) ### Other TikTok scrapers and related Actors | Actor | Best for | |-------|----------| | [TikTok Slideshow Downloader](https://apify.com/parsebird/tiktok-slideshow-downloader) | Saving every photo from TikTok photo-mode posts | | [TikTok Shop Reviews Scraper](https://apify.com/parsebird/tiktok-shop-reviews-scraper) | TikTok Shop product reviews and rating breakdowns | | [YouTube Shorts Downloader](https://apify.com/parsebird/youtube-shorts-downloader) | Downloading YouTube Shorts | | [Video & Audio Transcriber](https://apify.com/parsebird/video-audio-transcriber) | Transcribing downloaded story videos | ### FAQ **Can the creator see that I viewed their story?** No. The actor reads stories anonymously without a TikTok account, so no view is tied to you. **Why did a profile return no rows?** The profile had no active public story when the actor checked it. Stories expire 24 hours after posting. The run log lists each profile with "no active public stories". Private accounts show no public stories. Accounts that don't exist are listed as failed and are not charged. **Can I open the video links anywhere?** The links are signed by TikTok and expire after a while, so download videos soon after the run. In our tests, `media.videoUrl` downloaded without TikTok cookies from US IP addresses, while TikTok blocked it from some other countries (for example Brazil and Malaysia) and served only a placeholder in others. If you are outside the US, download through a US proxy or VPN, or run your download step on Apify. `media.watermarkedVideoUrl` and `music.playUrl` are tied to the TikTok session of the run and returned errors when opened later, so treat them as references and use `videoUrl` for downloads. Cover and avatar images open from anywhere. **Why is `watermarkedVideoUrl` null?** Photo stories have no video. For video stories it is `null` only when TikTok provides no separate watermarked file. **What does `profileOrder` mean?** The order TikTok shows stories on the profile, which is oldest first. **Can I check stories automatically every day?** Yes. Use [schedules](https://docs.apify.com/platform/schedules) to run the actor as often as you need, and connect the results to [integrations](https://apify.com/integrations). **Where can I report issues?** Open the **Issues** tab on the actor page with your input and run ID. # Changelog This Actor's version history is a separate document: https://apify.com/parsebird/tiktok-story-viewer/changelog.md # Actor input Schema ## `targets` (type: `array`): Add up to 500 TikTok usernames (hbomax), @handles (@tiktok), or profile URLs (https://www.tiktok.com/@tiktok). ## `maxStoriesPerProfile` (type: `integer`): Save at most this many active stories from each profile. Leave empty to save every active story. ## `sortStories` (type: `string`): Order of stories from each profile. The story limit keeps the first stories in this order. ## `proxyConfiguration` (type: `object`): The default (Apify Proxy, US) works for most runs. Change it only if you know you need different proxies. ## Actor input object example ```json { "targets": [ "hbo", "hbomax", "jamescharles", "tiktok", "wnba", "jasonderulo" ], "maxStoriesPerProfile": 10, "sortStories": "newest", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "targets": [ "hbo", "hbomax", "jamescharles", "tiktok", "wnba", "jasonderulo" ], "maxStoriesPerProfile": 10, "sortStories": "newest", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/tiktok-story-viewer").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "targets": [ "hbo", "hbomax", "jamescharles", "tiktok", "wnba", "jasonderulo", ], "maxStoriesPerProfile": 10, "sortStories": "newest", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("parsebird/tiktok-story-viewer").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "targets": [ "hbo", "hbomax", "jamescharles", "tiktok", "wnba", "jasonderulo" ], "maxStoriesPerProfile": 10, "sortStories": "newest", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } }' | apify call parsebird/tiktok-story-viewer --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/tiktok-story-viewer" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/9mNBlnVV2fzd3VwtV/builds/gs4cjYe6GiPWSoJEh/openapi.json