TikTok Scraper — Profiles, Posts & Video Details
Pricing
from $1.50 / 1,000 tiktok profiles
Go to Apify Store
Complete
Complete
Complete
Complete
Complete
TikTok Scraper — Profiles, Posts & Video Details
Extract TikTok profiles, recent posts, video and photo details, photo search results, playlists, and LIVE status with low-traffic HTTP requests.
Pricing
from $1.50 / 1,000 tiktok profiles
Rating
0.0
(0)
Developer
ScrapingMonkey
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
3 days ago
Last modified
Categories
Share
TikTok Scraper — Profiles, Posts, Videos, Photos and LIVE Status
Extract structured public TikTok data with low-traffic HTTP requests. The Actor does not start Chrome, Playwright, or another browser and does not require a TikTok account, cookies, or an API key.
- Collect complete public profile identity, biography, counts, avatars, and account flags
- Return one profile row plus up to 22 recent media rows for each username
- Enrich recent posts with complete public engagement, author, music, hashtag, video, and photo data
- Extract individual video and photo/slideshow details from URLs or IDs
- Paginate public TikTok Photo Search results
- Resolve public creator playlist metadata and LIVE status
- Process inputs concurrently with retry, proxy-session rotation, filtering, sorting, and deduplication
- Export one stable 113-field contract through a single Results table
What can you do with this Actor?
| Mode | Input | Output | Best for |
|---|---|---|---|
auto | Supported TikTok URLs | Automatically detected profile, media, playlist, or LIVE rows | Mixed URL batches |
profile | Usernames or profile URLs | Public identity, biography, avatars, counts, and account flags | Creator research |
profilePosts | Usernames or profile URLs | One profile row plus up to 22 recent video/photo rows | Creator content monitoring |
video | Video URLs or numeric IDs | Complete public video metadata | Post and campaign analysis |
photo | Photo URLs or numeric IDs | Slideshow metadata and ordered image URLs | Visual content research |
searchPhotos | Keywords | Paginated public Photo Search rows | Visual trend discovery |
playlist | Complete playlist URLs | Matching public playlist metadata | Series and collection research |
liveStatus | Usernames, LIVE URLs, or room IDs | Public room availability/status | Stream monitoring |
Top Search, Video Search, User Search, hashtag/music feeds, Explore, For You, and LIVE discovery are intentionally not advertised: current public web routes require short-lived TikTok signatures or a live browser session. Removing those modes keeps the Actor fast and economically sustainable.
Quick start
- Select Profile and recent posts.
- Enter one or more usernames such as
tiktokornasa. - Keep
maxResultsat 10 for the first run. - Leave HTTP enrichment enabled when complete engagement and media fields are required.
- Start the Actor and open the single Results table.
Input examples
Profile details
Profile plus recent posts
Fast profile posts without per-item enrichment
Auto-detect a mixed URL batch
Video details
Photo or slideshow details
Photo Search
Playlist metadata
LIVE status
maxResults applies to media rows for each profile or Photo Search keyword. profilePosts also returns one profile row. TikTok's unsigned public embed route currently exposes at most 22 recent profile posts. maxTotalResults caps the combined deduplicated run.
Complete output examples
The implementation always initializes the complete 113-field top-level contract. Optional public data is represented by null; list fields use []. No separate dataset error records or Errors view are created. Safe failure counts are written to RUN_SUMMARY and the run log. raw is null unless includeRaw is enabled; when enabled it contains a sanitized source-defined TikTok object whose session, cookie, token, signature and device identifiers are removed.
Complete profile output — 113 top-level fields
The profile details row uses the same stable 113-field contract. Fields that do not apply to this record type are explicitly returned as null or [].
Complete media-video output — 113 top-level fields
The video media row uses the same stable 113-field contract. Fields that do not apply to this record type are explicitly returned as null or [].
Complete media-photo output — 113 top-level fields
The photo or slideshow media row uses the same stable 113-field contract. Fields that do not apply to this record type are explicitly returned as null or [].
Complete playlist output — 113 top-level fields
The playlist details row uses the same stable 113-field contract. Fields that do not apply to this record type are explicitly returned as null or [].
Complete live-status output — 113 top-level fields
The LIVE status row uses the same complete contract. An offline creator has isLive: false; when TikTok exposes a room ID, the Actor also calls the public status endpoint.
What data can you extract?
Every output key is listed below.
| Category | Fields |
|---|---|
| Record and source | recordType, resultType, id, url, sourceMode, sourceTarget, sourceUrl, finalUrl, sourceEndpoints, transport, position, scrapedAt, country, language, availability, isPartial, fallbackUsed |
| Creator identity | username, nickname, authorId, secUid, signature, avatarThumb, avatarMedium, avatarLarge, isVerified, isPrivate, isBusinessAccount, bioLink |
| Creator metrics | followersCount, followingCount, friendsCount, heartsCount, likesGivenCount, videosCount |
| Content | description, createTime, createTimeIso, mediaType, durationSeconds, width, height, ratio, format, codecType, definition |
| Media URLs | videoUrl, downloadUrl, coverUrl, dynamicCoverUrl, originCoverUrl, imageUrls, imageCount |
| Content flags | isAd, isOriginal, isOfficial, isSecret, isCollected, isReviewing, commentsEnabled, downloadEnabled, duetEnabled, stitchEnabled, textLanguage, aigcDescription |
| Engagement | likesCount, commentsCount, sharesCount, viewsCount, savesCount |
| Tags | hashtags, mentions |
| Music | musicId, musicTitle, musicAuthor, musicAlbum, musicUrl, musicCoverUrl, musicDurationSeconds, musicOriginal, musicCopyrighted, musicCommercial |
| Hashtag | hashtagId, hashtagName, hashtagTitle, hashtagDescription, hashtagVideoCount, hashtagViewCount |
| Playlist | playlistId, playlistName, playlistVideoCount, playlistCoverUrl |
| LIVE | roomId, liveStatus, isLive, liveTitle, liveViewerCount, liveLikeCount, liveStartTime, liveCoverUrl, liveStreamUrls, liveHashtag, liveAgeRestricted |
| Complete nested data | author, authorStats, stats, video, images, music, hashtag, playlist, live, raw |
Input parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
mode | string | Yes | profilePosts | auto, profile, profilePosts, video, photo, searchPhotos, playlist, or liveStatus |
startUrls | request[] | By mode | [] | Supported public TikTok URLs |
targets | string[] | By mode | ["tiktok"] | Usernames, URLs, media IDs, or LIVE room IDs |
searchTerms | string[] | Photo Search | [] | Photo Search keywords |
maxResults | integer | No | 20 | Media rows per profile or keyword, 0 for every HTTP-accessible result |
maxTotalResults | integer | No | 0 | Combined run cap; 0 disables the additional cap |
country | string | No | US | Residential proxy country and regional request hint |
language | string | No | en | HTML/API language and Accept-Language locale |
sort | string | No | relevance | relevance, latest, popular, or oldest |
publishedAfter | ISO string | No | — | Remove older media after extraction |
publishedBefore | ISO string | No | — | Remove newer media after extraction |
minLikes | integer | No | 0 | Minimum public likes; use enrichment for reliable post filtering |
minComments | integer | No | 0 | Minimum public comment count; use enrichment for reliable post filtering |
minViews | integer | No | 0 | Minimum public views/play count |
includeRaw | boolean | No | false | Include sanitized public source objects; increases Dataset size |
enrichPartialResults | boolean | No | true | Fetch complete public media HTML for lightweight recent-post rows |
maxConcurrency | integer | No | 5 | Parallel HTTP targets/enrichments, 1–25 |
maxSessionRotations | integer | No | 3 | Fresh residential proxy/session attempts, 1–6 |
navigationTimeoutSecs | integer | No | 45 | Per-request timeout, 15–120 seconds |
Use cases
Creator and influencer research
Collect creator identity, biography, verification, privacy flags, follower/following counts, total hearts, and video totals without opening profiles manually.
Recent creator content
Return the profile and up to 22 recent video/photo records together. Enable HTTP enrichment for complete likes, comments, shares, saves, music, hashtags, mentions, and media fields.
Individual post analysis
Extract complete public video or slideshow metadata from specific URLs, including engagement, author, sound attribution, ordered image URLs, and available playback/cover URLs.
Visual trend discovery
Paginate Photo Search by keyword and apply local date, engagement, popularity, and total-result controls.
Playlist and LIVE monitoring
Resolve public creator playlist metadata and schedule repeated LIVE-status checks through Apify schedules, webhooks, or API integrations.
Performance and cost
The Actor uses HTTP/2-capable browser-TLS impersonation but never starts a browser. It downloads only the required HTML documents and JSON responses; it does not load JavaScript bundles, fonts, videos, or background browser resources.
Measured local smoke examples through residential test proxies:
| Workflow | Requests | Decoded response bytes | Rows |
|---|---|---|---|
| Profile | 1 | about 368 KB | 1 |
| Profile plus five lightweight posts | 2 | about 379 KB | 6 |
| Video detail | 1 | about 392 KB | 1 |
| Photo Search, five results | 2 | about 410 KB | 5 |
| Playlist metadata | 2 | about 374 KB | 1 |
These are decoded application bytes from representative runs, not guaranteed proxy-billing bytes. Response size varies by profile, locale, TikTok experiments, and optional enrichment. Enriching five recent posts adds up to five media-detail HTTP requests.
Only successfully saved Dataset rows trigger result events. Empty pages, retries, blocks, duplicates, filters, and failed inputs do not create a custom error event.
| Saved row | PPE event |
|---|---|
| Public profile | profile-result |
| Video or photo | video-photo-result |
| Playlist metadata | playlist-result |
| LIVE status | live-result |
The Store Pricing tab is the source of truth for current prices.
API usage
After a run, retrieve the single Results view through the Dataset API:
Run the Actor through the Apify API, schedule recurring checks, or connect successful runs to webhooks and downstream automations. The same complete field contract is available in JSON, CSV, Excel, XML, and RSS exports.
Best for / not for
Best for: public creator intelligence, recent creator posts, individual video/photo details, photo trend datasets, playlist inventories, and public LIVE-status monitoring.
Not for: Top/Video/User Search, hashtag or music feeds, Explore, For You, LIVE discovery, private profiles, follower/following lists, comment threads, TikTok Shop, authenticated feeds, media-file downloads, stream recording, or CAPTCHA-protected content.
Limits and good to know
profilePostsexposes at most 22 recent items through TikTok's unsigned embed route. Cursor pagination is not available on that route.- Lightweight recent-post rows contain description, author identifiers, play count, covers, and playback URL. They are marked
isPartial: trueuntil successfully enriched. - Enrichment remains HTTP-only but performs one additional public media request per partial row.
- Individual photo pages are resolved through the same public SSR data path TikTok uses for the media ID, allowing ordered slideshow image URLs to be extracted without a browser.
- Photo Search requires one lightweight HTML warm-up request per keyword before JSON pagination.
- Country selects the mandatory residential proxy region, but TikTok ultimately controls regional availability and ranking.
- Signed CDN media URLs can expire. Store or process them promptly when your workflow permits.
- The 113-field contract is stable, but fields that do not apply to a record type use
nullor[]. includeRawcan substantially increase Dataset transfer and storage.
Frequently asked questions
What input should I provide?
Use usernames for profile workflows, complete TikTok URLs for media/playlist workflows, keywords for Photo Search, and usernames or numeric room IDs for LIVE status. Auto mode accepts only the URL types listed above.
Why does Profile posts return one extra row?
The first row is the requested public profile. maxResults limits the following media rows, matching the common creator-research workflow of receiving profile context and recent posts together.
How many recent profile posts can I extract?
Up to 22 per username with the current unsigned public embed endpoint. Higher values do not create browser pagination or hidden additional charges.
Why are some recent-post fields empty?
The low-traffic embed response intentionally contains fewer fields. Keep enrichPartialResults enabled to request complete public details for each post. Failed enrichment keeps the lightweight row with isPartial: true instead of discarding useful data.
Can I process multiple inputs?
Yes. Add multiple usernames, URLs, room IDs, or Photo Search keywords. maxResults applies independently and maxTotalResults caps the combined run.
Do I need a TikTok account, API key, cookies, or proxy settings?
No account, API key, saved cookies, or user-facing proxy configuration is required. Published runs automatically use Apify Residential Proxy, and first-party cookies live only inside an isolated HTTP session.
Does the Actor extract comments or follower lists?
No. Media rows include public comment counts, while complete comment threads and follower/following lists are outside this public HTTP-only product boundary.
Responsible use
Use the Actor only for lawful collection of publicly available data. Respect privacy, intellectual-property rights, platform terms, applicable laws, and reasonable request volumes. Do not use it to bypass access controls or collect private information.
Support
If a public target repeatedly returns no rows, include the mode, sanitized input, run ID, country, and approximate time in an Apify issue. Never post proxy credentials, cookies, signed media URLs, or authentication data in a public issue.
