Tiktok Profile Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

Tiktok Profile Scraper

Tiktok Profile Scraper is a fast, reliable Apify actor that extracts public TikTok profile posts and engagement data at scale. It solves the manual, error-prone task of collecting post-level insights by automating profile parsing, pagination, sorting, and filtering — ideal for marketers, developers, data analysts, and researchers. With configurable sorting, time windows, and engagement thresholds, it enables large-scale influencer research, competitive monitoring, and audience analysis — all saved to your Apify dataset in real time.

What data / output can you get?

Below are examples of the structured fields this actor saves for each post it collects. Fields use real keys exactly as they appear in the output.

Bonus metadata includes nested authorMeta (e.g., verified, follower counts), musicMeta (author, original, playUrl), videoMeta (dimensions, cover URLs, subtitleLinks), locationMeta, mentions, effectStickers, and flags such as isPinned, isSlideshow, and isSponsored. Results are stored in your Apify dataset and mirrored to an actor.json file for convenient consumption.

Key features

• ⚡ Robust proxy fallback & resilience — Automatic proxy handling escalates from direct to datacenter to residential on 403/429 or empty/blocked responses, with residential retries for tough pages.
• 🔀 Flexible video sorting — Choose profileSorting: latest, oldest, or popular to organize posts by chronology or engagement signal.
• 🧰 Precise filters — Limit by date range (oldestPostDateUnified, newestPostDate), engagement thresholds (mostDiggs, leastDiggs), and excludePinnedPosts to avoid pinned content.
• 📦 Real-time dataset streaming — Posts are pushed to the Apify dataset as they’re scraped, plus an actor.json file is saved at the end of the run.
• 👥 Multi-profile input — Supply multiple usernames in profiles to process accounts in one run.
• 🛡️ Controlled access — Configure proxyConfiguration to fit your environment; the actor starts with no proxy by default and escalates only when needed.
• 🧑‍💻 Developer-friendly — Clear JSON inputs/outputs, deterministic field names, and predictable sorting/filtering behavior for pipeline integration.

How to use Tiktok Profile Scraper - step by step

1. Sign in to Apify and open the Tiktok Profile Scraper actor.
2. Add input data:
   • In profiles, enter TikTok usernames (one per line). “@” is optional; the actor normalizes it.
   • Optionally adjust profileSorting (latest, popular, oldest) and resultsPerPage.
   • Optionally set date filters (oldestPostDateUnified, newestPostDate) and engagement filters (mostDiggs, leastDiggs).
   • Toggle excludePinnedPosts if you want to skip pinned videos.
   • Configure proxyConfiguration if needed; by default, the actor starts without a proxy and escalates automatically only when blocked.
3. Start the run. The actor fetches each profile page, extracts initial posts, and uses TikTok’s item_list API for additional pagination when available.
4. During the run, items are streamed into your Apify dataset.
5. After completion, the actor saves a consolidated actor.json file with all unique posts collected.
6. Download results from the Apify dataset or retrieve the actor.json file from the run’s storage for your workflows.

Pro tip: Popular sorting combined with date filters may produce limited results due to how TikTok returns popularity-based pages. Consider using latest or oldest when applying time windows.

Use cases

Why choose Tiktok Profile Scraper?

• 🎯 Precision-first scraping: Extracts structured, post-level data with stable field names and nested metadata.
• 🌍 Sorting & filtering control: Apply time windows and engagement thresholds; choose latest, oldest, or popular ordering.
• 📈 Scales to many profiles: Accepts multiple usernames and streams results as they’re found.
• 🧑‍💻 Built for developers: Clean JSON I/O and predictable behavior make it easy to integrate into pipelines and analytics.
• 🔒 Safe & reliable: Starts direct and escalates to datacenter/residential proxies on blocks for maximum success.
• 💾 Storage flexibility: Writes to the Apify dataset in real time and produces a final actor.json file for convenience.
• 🧩 Better than manual/browser tools: No unstable extensions; production-grade network handling and dataset storage.

Is it legal / ethical to use Tiktok Profile Scraper?

Yes — when done responsibly. This actor extracts publicly available profile content and does not log in or access private profiles. Users should:

• Scrape only public data and respect platform terms.
• Avoid collecting sensitive or non-public information.
• Ensure compliance with applicable regulations (e.g., GDPR/CCPA) and internal policies.
• Consult legal counsel for edge cases in your jurisdiction or use case.

The tool does not access private profiles or authenticated data and operates without login.

Input parameters & output format

Example input (JSON)

{
"profiles":["mrbeast","charlidamelio"],
"profileScrapeSections":["videos"],
"profileSorting":"latest",
"resultsPerPage":20,
"oldestPostDateUnified":"2026-03-01",
"newestPostDate":"0",
"mostDiggs":500000,
"leastDiggs":10000,
"excludePinnedPosts":false,
"proxyConfiguration":{
"useApifyProxy":false
}
}

Parameters

Notes:

• The actor normalizes usernames with or without “@”.
• Internally, date inputs are parsed into Unix timestamps for filtering.
• Sorting applies to videos; the actor sets fromProfileSection to "videos" in outputs.

Example output (JSON)

[
{
"id":"7330123456789012345",
"text":"New video just dropped! 🚀",
"textLanguage":"en",
"createTime":1740832496,
"createTimeISO":"2026-03-01T12:34:56Z",
"isAd":false,
"authorMeta":{
"id":"1234567890",
"name":"mrbeast",
"profileUrl":"https://www.tiktok.com/@mrbeast",
"nickName":"MrBeast",
"verified":true,
"signature":"",
"bioLink":null,
"originalAvatarUrl":"https://p16-sign-va.tiktokcdn.com/.../avatar-720x720.jpeg",
"avatar":"https://p16-sign-va.tiktokcdn.com/.../avatar-200x200.jpeg",
"commerceUserInfo":{"commerceUser":false},
"privateAccount":false,
"roomId":"",
"ttSeller":false,
"followDatasetUrl":null,
"following":0,
"friends":0,
"fans":0,
"heart":0,
"video":0,
"digg":0
},
"musicMeta":{
"musicName":"original sound",
"musicAuthor":"MrBeast",
"musicOriginal":true,
"playUrl":"https://sf16-ies-music-sg.tiktokcdn.com/obj/...mp3",
"coverMediumUrl":"https://p16.tiktokcdn.com/.../cover.jpg",
"originalCoverMediumUrl":"https://p16.tiktokcdn.com/.../cover.jpg",
"musicId":"7123456789012345678"
},
"locationMeta":{
"address":"",
"city":"",
"cityCode":"",
"countryCode":"",
"locationName":"",
"locationId":""
},
"webVideoUrl":"https://www.tiktok.com/@mrbeast/video/7330123456789012345",
"mediaUrls":[],
"commentsDatasetUrl":null,
"videoMeta":{
"height":1920,
"width":1080,
"duration":21,
"coverUrl":"https://p16-sign.tiktokcdn.com/obj/...jpeg",
"originalCoverUrl":"https://p16-sign.tiktokcdn.com/obj/...jpeg",
"definition":"high",
"format":"mp4",
"subtitleLinks":[]
},
"diggCount":152340,
"shareCount":4200,
"playCount":4821930,
"collectCount":800,
"commentCount":1287,
"repostCount":0,
"mentions":[],
"detailedMentions":[],
"hashtags":[
{"name":"giveaway"}
],
"effectStickers":[],
"isSlideshow":false,
"isPinned":false,
"isSponsored":false,
"input":"mrbeast",
"fromProfileSection":"videos"
}
]

Field notes:

• hashtags is an array of objects with “name”.
• mentions and detailedMentions include user identifiers when present.
• subtitleLinks may contain language, downloadLink, tiktokLink, source, sourceUnabbreviated, and version.
• createTimeISO is null if createTime is missing.

Related tools

FAQ

Do I need to log in to use this scraper?

No. The actor does not require login and targets publicly available profile content only.

Can I sort by popularity instead of time?

Yes. Set profileSorting to "popular". Note that combining popularity sorting with date filters may limit results due to how TikTok serves popularity-ordered pages.

How many posts can I collect per profile?

Use resultsPerPage to set the maximum number of posts to collect per profile. The actor also removes duplicates and stops when pagination yields no progress.

Can I filter by date range or hearts?

Yes. Use oldestPostDateUnified and newestPostDate for time windows, and mostDiggs or leastDiggs for hearts thresholds. Hearts filters are disabled when date filters are enabled.

Does it handle pinned posts?

Yes. Set excludePinnedPosts to true to skip pinned videos at the top of a profile.

What about proxies — are they required?

Not initially. The actor starts with a direct connection and automatically escalates to datacenter and then residential proxies if it encounters blocks (403/429) or empty/blocked responses.

What formats can I use to consume results?

Data is pushed to your Apify dataset during the run, and a final actor.json file is written on completion. You can integrate these into your pipelines or download from the run’s storage.

Does it scrape reposts?

The input supports selecting content sections, but outputs include fromProfileSection: "videos" to reflect collected items. Sorting applies to the Videos section.

Final thoughts

Tiktok Profile Scraper is built to extract structured, post-level TikTok data quickly and reliably. With configurable sorting, robust filtering, resilient proxy fallback, and real-time dataset streaming, it’s ideal for marketers, developers, analysts, and researchers. Automate runs, consume actor.json or datasets in your pipelines, and start turning public TikTok profile posts into actionable insights today.