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

{
  "maxItems": 10,
  "regionObservation": "US"
}

Example: larger feed sample

{
  "maxItems": 100,
  "regionObservation": "US"
}

Example: daily trend monitoring run

{
  "maxItems": 50,
  "regionObservation": "US"
}

Example: extended collection

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