# TikTok For You Feed Scraper (`crawlerbros/tiktok-for-you-scraper`) Actor Capture a snapshot of TikTok's For You (FYP) feed posts as an anonymous regional observer. No cookies required. - **URL**: https://apify.com/crawlerbros/tiktok-for-you-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Social media, Automation, Videos - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## TikTok For You Scraper Capture an anonymous snapshot of TikTok's For You Page (FYP) feed via TikTok's recommendation API. No login, account, or cookies required. Each run returns a fresh set of posts from TikTok's anonymous regional recommendation engine, not a personalized feed tied to any user. ### What this actor does - Loads TikTok's For You feed as an anonymous regional observer and intercepts the recommendation API calls made on page load - Returns full post rows enriched with `feedType: "foryou"`, `observedRegion`, and `isPersonalized` labels - Captures engagement stats from TikTok's `statsV2` field for accuracy on high-view-count videos - Includes author profile, music metadata, video technical details, and hashtags for every post - Scrolls the page to trigger additional API batches until the requested item count is reached - Empty fields are omitted ### Output per post - `feedType` — always `"foryou"` - `observedRegion` — ISO country code label from the `regionObservation` input - `isPersonalized` — always `false` (anonymous, session-bound feed, not tied to any account) - `postId` — unique TikTok video ID - `postUrl` — direct URL to the video - `caption` — full caption text - `likeCount` — total likes - `commentCount` — total comments - `shareCount` — total shares - `playCount` — total plays/views - `author.id` — author's TikTok user ID - `author.username` — author handle - `author.displayName` — author display name - `author.verified` — verification status - `author.avatarUrl` — author profile image URL - `music.id` — sound ID - `music.title` — sound title - `music.authorName` — sound creator name - `music.original` — whether it is an original sound - `video.width` — video width in pixels - `video.height` — video height in pixels - `video.duration` — video duration in seconds - `video.playUrl` — streamable video URL (expires) - `video.cover` — cover/thumbnail image URL - `hashtags` — array of hashtag names parsed from caption - `scrapedAt` — ISO 8601 timestamp of when the record was collected ### Input | Field | Type | Default | Description | |---|---|---|---| | `maxItems` | integer | 30 | Maximum For You feed posts to collect per run (1–300). | | `regionObservation` | string | `"US"` | ISO country code label for this observation (informational only — actual region is server IP-based). | #### Example: US feed snapshot ```json { "maxItems": 10, "regionObservation": "US" } ```` #### Example: larger feed sample ```json { "maxItems": 100, "regionObservation": "US" } ``` #### Example: daily trend monitoring run ```json { "maxItems": 50, "regionObservation": "US" } ``` #### Example: extended collection ```json { "maxItems": 300, "regionObservation": "GB" } ``` ### Use cases - **Content trend researchers** identifying what video formats and topics are currently surfacing in TikTok's recommendation engine - **Brand monitoring teams** spotting branded or sponsored content appearing in organic anonymous feeds - **Competitive intelligence analysts** observing which creators and styles are being algorithmically promoted - **Academic researchers** building unbiased FYP datasets to study TikTok's content distribution by region - **Media companies** tracking the pulse of trending content in specific markets - **Developers** powering trend dashboards or alert systems with a live snapshot of TikTok's recommendation output ### FAQ **Q: Is this a personalized feed?**\ A: No. The actor operates as an anonymous visitor with no account. TikTok assigns a temporary anonymous session identifier, but the feed is not linked to any user profile or watch history. **Q: Can I control which region's For You feed I see?**\ A: The `regionObservation` field is an informational label only. The actual feed content is determined by TikTok's server-side IP region detection. If you need a specific geographic feed, use Apify proxy with a country-targeted IP. **Q: Will I get the same videos every run?**\ A: No. Each run gets a unique anonymous session, producing a different feed snapshot. Results are non-deterministic. **Q: How many posts can I collect per run?**\ A: Up to 300 per run. TikTok serves approximately 6 posts per API call and the actor scrolls the page to trigger additional batches. **Q: Are video play URLs accessible after scraping?**\ A: Play URLs are signed and expire, typically within 24 hours of collection. Use `postUrl` as the stable reference. **Q: Do I need a TikTok account or cookies?**\ A: No. The actor operates fully anonymously. No credentials, session cookies, or proxy are required. **Q: What does `isPersonalized` mean if it is always false?**\ A: It is a label distinguishing this feed type from a logged-in personalized feed. It confirms the data represents an anonymous regional observation rather than any user's actual feed. ### Related TikTok Scrapers Build a complete TikTok data pipeline with our full suite: | Scraper | URL | |---|---| | TikTok Post Scraper | https://apify.com/crawlerbros/tiktok-post-scraper | | TikTok Profile Scraper | https://apify.com/crawlerbros/tiktok-profile-scraper | | TikTok Comments Scraper | https://apify.com/crawlerbros/tiktok-comments-scraper | | TikTok Search Scraper | https://apify.com/crawlerbros/tiktok-search-scraper | | TikTok Hashtag Scraper | https://apify.com/crawlerbros/tiktok-hashtag-scraper | | TikTok Music Scraper | https://apify.com/crawlerbros/tiktok-music-scraper | | TikTok Transcript Scraper | https://apify.com/crawlerbros/tiktok-transcript-scraper | | TikTok Followers Scraper | https://apify.com/crawlerbros/tiktok-followers-scraper | | TikTok Mention Scraper | https://apify.com/crawlerbros/tiktok-mention-scraper | | TikTok Profile Mention Scraper | https://apify.com/crawlerbros/tiktok-profile-mention-scraper | | TikTok Playlist Scraper | https://apify.com/crawlerbros/tiktok-playlist-scraper | | TikTok Explore Scraper | https://apify.com/crawlerbros/tiktok-explore-scraper | | TikTok Downloader | https://apify.com/crawlerbros/tiktok-downloader-api | | TikTok Ads Library Scraper | https://apify.com/crawlerbros/tiktok-ads-library-scraper-pro | | TikTok Top Ads Scraper | https://apify.com/crawlerbros/tiktok-top-ads-scraper | | TikTok Hashtag Trends Scraper | https://apify.com/crawlerbros/tiktok-hashtag-trends-scraper | | TikTok LIVE Scraper | https://apify.com/crawlerbros/tiktok-live-scraper | # Actor input Schema ## `maxItems` (type: `integer`): Maximum number of For You feed posts to collect. Set to 0 to return no items. ## `regionObservation` (type: `string`): ISO country code to label the observation (e.g. US, GB). This is informational only — TikTok determines the actual region based on server IP. ## Actor input object example ```json { "maxItems": 10, "regionObservation": "US" } ``` # Actor output Schema ## `data` (type: `string`): Dataset containing TikTok For You feed post records. Each row includes postId, postUrl, caption, feedType, observedRegion, isPersonalized, playCount, likeCount, commentCount, shareCount, createdAt, author, music, video, hashtags. # 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 = { "maxItems": 10, "regionObservation": "US" }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/tiktok-for-you-scraper").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 = { "maxItems": 10, "regionObservation": "US", } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/tiktok-for-you-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "maxItems": 10, "regionObservation": "US" }' | apify call crawlerbros/tiktok-for-you-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/tiktok-for-you-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok For You Feed Scraper", "description": "Capture a snapshot of TikTok's For You (FYP) feed posts as an anonymous regional observer. No cookies required.", "version": "1.0", "x-build-id": "TfuFL60JK1PtuwUF7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~tiktok-for-you-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-tiktok-for-you-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~tiktok-for-you-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-tiktok-for-you-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~tiktok-for-you-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-tiktok-for-you-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Maximum Items", "minimum": 0, "maximum": 300, "type": "integer", "description": "Maximum number of For You feed posts to collect. Set to 0 to return no items.", "default": 30 }, "regionObservation": { "title": "Region (Informational)", "type": "string", "description": "ISO country code to label the observation (e.g. US, GB). This is informational only — TikTok determines the actual region based on server IP.", "default": "US" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```