# Tiktok For You Scraper (`romy/tiktok-for-you-scraper`) Actor Scrape the personalized TikTok feed for any account using a session ID. Get the real videos that appear on a specific persona's For You Page (FYP) or Following feed — not anonymous, not generic, but exactly what that account sees. - **URL**: https://apify.com/romy/tiktok-for-you-scraper.md - **Developed by:** [Romy](https://apify.com/romy) (community) - **Categories:** Social media, Videos, Developer tools - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 video scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Page Scraper **Scrape the personalized TikTok feed for any account using a session ID.** Get the real videos that appear on a specific persona's For You Page (FYP) or Following feed — not anonymous, not generic, but exactly what that account sees. Built for brands, buzzer agencies, and researchers who manage multiple TikTok personas and need to monitor what content TikTok surfaces to each one. --- ### What does TikTok For You Scraper do? It authenticates as a specific TikTok account (via `sessionid` cookie) and fetches the personalized video feed that account sees — including video metadata, author details, engagement stats, music, and share URLs. Unlike anonymous scrapers that return regional trends, this actor returns **account-specific content** shaped by that persona's watch history, interests, and behavior. --- ### Why use TikTok For You Scraper? - **Persona auditing** — Know exactly what TikTok shows to each of your managed accounts. Compare FYPs across personas in the same niche. - **Competitor intelligence** — See what content TikTok surfaces to accounts in your target audience. - **Content strategy** — Understand which topics and formats dominate the feed for a given persona profile. - **Brand safety** — Detect harmful or irrelevant content showing up on your client's personas. - **Research** — Study TikTok's recommendation algorithm behavior across different account profiles. --- ### How to use TikTok For You Scraper #### Step 1: Get your TikTok session ID 1. Log in to [tiktok.com](https://www.tiktok.com) in **Chrome** or **Firefox** on desktop 2. Open **DevTools**: press `F12` (Windows/Linux) or `Cmd+Option+I` (Mac) 3. Go to the **Application** tab → expand **Cookies** in the left sidebar → click `https://www.tiktok.com` 4. In the cookie list, find the row named **`sessionid`** 5. Click on it and copy the long string in the **Value** column Your `sessionid` looks like this — a 32-character hex string: ```` 2e5bd35c9608c51f1c8b6aa17b555160 ``` If you see a long cookie string (all cookies at once), find `sessionid=` and copy only the value after the `=` sign, up to the next `;`: ``` ...sessionid=2e5bd35c9608c51f1c8b6aa17b555160;sid\_tt=... ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ copy only this part ```` > ⚠️ Keep your session ID private. It grants full access to your account. Never share it publicly. #### Step 2: Configure the actor Fill in the input: ```json { "sessionId": "your_session_id_here", "feedType": "fyp", "maxItems": 50 } ```` Available `feedType` values: `fyp`, `following`, `nearby`, `drama`, `live`. ```json ``` #### Step 3: Run and get results The actor streams videos directly to your dataset. Download as JSON, CSV, or Excel when done. *** ### Input | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `sessionId` | string | ✅ | — | TikTok `sessionid` cookie value | | `feedType` | string | — | `fyp` | Feed to scrape — see table below | | `maxItems` | integer | — | `50` | Max videos to fetch (1–500) | #### Feed types | `feedType` | Feed | Description | |------------|------|-------------| | `fyp` | For You Page | Personalized recommendation feed (default) | | `following` | Following | Videos from accounts the persona follows | | `nearby` | Nearby | Videos near the account's registered location | | `drama` | Drama / Series | TikTok drama and episodic series content | | `live` | Live Streams | Currently live streams surfaced to the account | *** ### Output Each item in the dataset is the **raw TikTok API response** for one video. Key fields: ```json { "aweme_id": "7659256277335428372", "desc": "POV: when the algorithm knows you too well 😭", "create_time": 1751234567, "author": { "unique_id": "username123", "nickname": "Creator Name", "follower_count": 284000, "region": "ID" }, "statistics": { "play_count": 1420000, "digg_count": 89300, "comment_count": 1240, "share_count": 4200, "collect_count": 12100 }, "music": { "title": "original sound", "author": "username123" }, "share_url": "https://t.tiktok.com/i18n/share/video/7659256277335428372/...", "is_ads": false, "region": "ID" } ``` You can download the dataset in **JSON, CSV, Excel, or XML** from the Apify Console. *** ### Data fields reference | Field | Description | |-------|-------------| | `aweme_id` | Unique video ID | | `desc` | Video caption / description | | `create_time` | Unix timestamp of upload | | `author.unique_id` | Creator's TikTok username | | `author.follower_count` | Creator's follower count | | `statistics.play_count` | Total views | | `statistics.digg_count` | Total likes | | `statistics.comment_count` | Total comments | | `statistics.share_count` | Total shares | | `statistics.collect_count` | Total saves/bookmarks | | `music.title` | Background music title | | `share_url` | Direct video link | | `is_ads` | Whether the video is a paid promotion | | `region` | Content region code | *** ### Pricing This actor uses **Pay Per Event** pricing: | Event | Price | |-------|-------| | Actor start | $0.05 | | Per video scraped | $0.008 | **Example cost estimates:** - 50 videos → ~$0.45 - 200 videos → ~$1.65 - 500 videos → ~$4.05 *** ### Tips - **Session freshness** — TikTok sessions last weeks to months. If you get a "Login expired" error, re-copy your `sessionid` cookie. - **Multiple personas** — Run one actor instance per persona. Each session ID produces a different FYP. - **Following feed** — Set `feedType: "following"` to scrape only content from accounts that persona follows — useful for competitor monitoring. - **Nearby feed** — Set `feedType: "nearby"` to get hyper-local content near the account's region — useful for local business intelligence. - **Drama feed** — Set `feedType: "drama"` to scrape TikTok's episodic drama/series content. - **Live feed** — Set `feedType: "live"` to get live streams currently surfaced to that account. - **Schedule runs** — Use Apify Scheduler to capture FYP snapshots daily or weekly for trend analysis. - **Export & analyze** — Download CSV and load into Google Sheets or Excel for side-by-side persona comparison. *** ### How we compare | Feature | **TikTok For You Scraper** (this) | crawlerbros/tiktok-for-you-scraper | |---------|----------------------------------|-------------------------------------| | Personalized FYP | ✅ Session-based | ❌ Anonymous only | | Following feed | ✅ Supported | ❌ Not supported | | Nearby / Drama / Live | ✅ 5 feed types | ❌ FYP only | | Session ID input | ✅ Yes | ❌ No | | Raw API output | ✅ Full video object | ⚠️ Limited | | Multiple personas | ✅ One run per session | ❌ Not applicable | | Pricing | Pay per video | Free (limited) | The key difference: other FYP scrapers return **generic regional content** — they show what's trending, not what *your account* sees. This actor fetches the actual personalized feed tied to a specific `sessionid`, making it useful for persona auditing and buzzer agency workflows. *** ### FAQ **Is this legal?** This actor accesses data from TikTok's mobile API using your own account credentials. Use it only for accounts you own or have permission to access. Always comply with TikTok's Terms of Service and applicable data regulations in your jurisdiction. **Will TikTok detect or ban my account?** The actor uses the same mobile API calls as the official TikTok app. Keep request volume reasonable and avoid scraping continuously without breaks. **Why is my FYP different every run?** That's how TikTok works — the algorithm updates your feed in real time based on fresh signals. Each run captures a snapshot of that moment. **Does it support multiple accounts in one run?** Not currently. Run a separate actor instance per session ID. *** ### Support Found a bug or need a custom feature? Open an issue on the actor's page or contact the developer directly. # Actor input Schema ## `sessionId` (type: `string`): Your TikTok session ID (the value of the 'sessionid' cookie). Log in to TikTok in your browser, open DevTools → Application → Cookies → tiktok.com, copy the 'sessionid' value. ## `feedType` (type: `string`): Which feed to scrape. 'fyp' = personalized For You Page, 'following' = accounts you follow, 'nearby' = videos near your location, 'drama' = drama/series content, 'live' = live streams feed. ## `maxItems` (type: `integer`): Maximum number of videos to scrape (1–500). Default: 50. ## Actor input object example ```json { "feedType": "fyp", "maxItems": 50 } ``` # Actor output Schema ## `dataset` (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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("romy/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 = {} # Run the Actor and wait for it to finish run = client.actor("romy/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 '{}' | apify call romy/tiktok-for-you-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=romy/tiktok-for-you-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Tiktok For You Scraper", "description": "Scrape the personalized TikTok feed for any account using a session ID. Get the real videos that appear on a specific persona's For You Page (FYP) or Following feed — not anonymous, not generic, but exactly what that account sees.", "version": "0.0", "x-build-id": "9xIAJEdkfVb7GoGFU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/romy~tiktok-for-you-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-romy-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/romy~tiktok-for-you-scraper/runs": { "post": { "operationId": "runs-sync-romy-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/romy~tiktok-for-you-scraper/run-sync": { "post": { "operationId": "run-sync-romy-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", "required": [ "sessionId" ], "properties": { "sessionId": { "title": "Session ID", "type": "string", "description": "Your TikTok session ID (the value of the 'sessionid' cookie). Log in to TikTok in your browser, open DevTools → Application → Cookies → tiktok.com, copy the 'sessionid' value." }, "feedType": { "title": "Feed Type", "enum": [ "fyp", "following", "nearby", "drama", "live" ], "type": "string", "description": "Which feed to scrape. 'fyp' = personalized For You Page, 'following' = accounts you follow, 'nearby' = videos near your location, 'drama' = drama/series content, 'live' = live streams feed.", "default": "fyp" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of videos to scrape (1–500). Default: 50.", "default": 50 } } }, "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 } } } } } } } } } } ```