TikTok For You Page Scraper

Scrape the personalized TikTok For You Page (FYP) feed for any account using a session ID. Returns the actual videos TikTok surfaces to that specific persona — not anonymous trending content.

Built for brands, buzzer agencies, and researchers who manage multiple TikTok personas.

---

How it works

The actor authenticates as a TikTok account via sessionid cookie and calls the same mobile API endpoint the official app uses. It returns video metadata, author details, engagement stats, music info, and share URLs for each video in the feed.

Important: TikTok's FYP personalization is IP-sensitive. If the request comes from a country different from the account's registered region, TikTok serves generic global trending content instead of the account's real FYP. Use a residential proxy from the same country as the account to get accurate results.

---

Input

Field	Type	Default	Description
sessionId	string	—	TikTok sessionid cookie value. Leave empty for anonymous (non-personalized) feed
maxItems	integer	50	Max videos to scrape (1–500)
proxyConfiguration	object	—	Residential proxy config. Required for personalized results — use a proxy from the same country as the account

Example input

{
  "sessionId": "your_32char_session_id",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "ID"
  }
}

Getting your session ID

1. Log in to tiktok.com in Chrome/Firefox
2. Open DevTools → Application → Cookies → https://www.tiktok.com
3. Find sessionid and copy the value (32-character hex string)

Keep your session ID private — it grants full access to the account.

---

Output

Each item represents one video from the feed:

{
  "aweme_id": "7659256277335428372",
  "desc": "video caption here",
  "create_time": 1751234567,
  "share_url": "https://t.tiktok.com/i18n/share/video/...",
  "region": "ID",
  "language": "id",
  "author": {
    "uid": "123456789",
    "unique_id": "username123",
    "nickname": "Creator Name",
    "signature": "bio here",
    "region": "ID",
    "avatar_100": "https://...",
    "avatar_720": "https://..."
  },
  "video": {
    "play_urls": ["https://v19.tiktokcdn.com/..."],
    "cover": "https://...",
    "dynamic_cover": "https://...",
    "duration_ms": 15000,
    "width": 1080,
    "height": 1920
  },
  "music": {
    "id": "7234567890",
    "title": "original sound",
    "author": "username123",
    "owner_unique_id": "username123"
  },
  "statistics": {
    "play_count": 1420000,
    "digg_count": 89300,
    "comment_count": 1240,
    "share_count": 4200,
    "collect_count": 12100,
    "repost_count": 320
  }
}

---

Pricing

Pay Per Event:

Event	Price
Actor start	$0.05
Per video scraped	$0.008

Examples: 50 videos ≈ $0.45 · 200 videos ≈ $1.65 · 500 videos ≈ $4.05

---

Tips

• Use a residential proxy from the same country as the TikTok account. Without it, you get global trending content, not the account's real FYP.
• Session ID freshness — sessionid typically lasts weeks to months. Re-copy if you get 403 errors.
• Multiple personas — Run one actor instance per session ID. Each session produces a different FYP.
• Schedule runs — Use Apify Scheduler to capture daily FYP snapshots for trend analysis.

---

FAQ

Why does my FYP look generic (shows Shakira, viral global content)? You're not using a proxy, or the proxy country doesn't match the account's registered region. Add a residential proxy with apifyProxyCountry matching the account's country code.

Is this legal? This actor uses your own account credentials to access TikTok's mobile API. Use only on accounts you own or have permission to access. Comply with TikTok's Terms of Service and applicable laws in your jurisdiction.

Will TikTok detect or ban my account? The actor mimics official TikTok app API calls. Keep request volume reasonable and avoid continuous scraping without breaks.

Why is my FYP different each run? TikTok's algorithm updates the feed in real time. Each run captures a snapshot of that moment.