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 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:

{
  "sessionId": "your_session_id_here",
  "feedType": "fyp",
  "maxItems": 50
}

Available feedType values: fyp, following, nearby, drama, live.

undefined

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:

{
  "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.