Fast TikTok Scraper API | Influencer Data & Analytics API
Pricing
from $0.30 / 1,000 tiktok post items
Fast TikTok Scraper API | Influencer Data & Analytics API
TikTok Scraper API - fast TikTok data extraction for videos, profiles, hashtags, music, locations and search. 200 posts/sec, 98% success rate. $0.006/query with 10-20 posts FREE, then $0.0003/post. No login, proxies or API keys needed; JSON/CSV output for analytics.
Pricing
from $0.30 / 1,000 tiktok post items
Rating
5.0
(8)
Developer
API Dojo
Maintained by Apify PartnerActor stats
35
Bookmarked
1.5K
Total users
245
Monthly active users
5.3 hours
Issues response
6 hours ago
Last modified
Features
Share
TikTok Scraper API is an Apify actor that extracts TikTok posts from profiles, hashtags, keyword searches, music, locations and video URLs, and returns views, likes, creator and video data as JSON, CSV or Excel. It is built for marketers, researchers and data teams. Posts cost $0.30 per 1,000, plus a $0.003 to $0.006 fee per query that covers the first 10 or 20 posts.
The TikTok Scraper API accepts 6 source types, bills through 7 charge events, and needs no TikTok login, cookies or API key as input. Every price below is a per-event charge with no subscription and no monthly minimum.
| Input | TikTok URLs (profile, video, hashtag, search, music, location), keywords, usernames or hashtags |
| Price | $0.0003 per post ($0.30 per 1,000), plus $0.006 per user, search, hashtag or location query and $0.003 per music or single post query |
| Free posts | On paid plans, the first 20 posts of each user, search, hashtag and location query and the first 10 of each music query. Profile filters run first, so filtered posts reduce that count |
| Output | One dataset item per post: id, title, views, likes, comments, shares, bookmarks, hashtags, channel, video, song, subtitleInformation, postPage |
| Formats | JSON, CSV, Excel, XML, HTML, RSS (Apify dataset export) |
| Filters | Region (location, 249 country codes), search date range and sorting, profile sorting, date window, likes range and pinned posts |
| Limits | maxItems caps the run on paid plans (Free plan: 10 items); resultsPerPage caps each source (1 to 1,000,000) |
| Agent access | Apify API, Apify MCP server, MCP connectors for Notion and Todoist |
What Does the TikTok Scraper API Do?
The TikTok Scraper API collects public TikTok posts from 6 source types: user profiles, single videos, hashtags, keyword searches, music (sounds) and locations. Each post comes back with its engagement counts, creator profile, video file data and sound.
Listed below are the 6 jobs people run the TikTok Scraper API for.
- TikTok influencer research: profile posts with
views,likesandchannel.followers, from profile URLs or theprofilesfield. - TikTok hashtag tracking: posts under a tag with their engagement counts, from
https://www.tiktok.com/tag/{hashtag}URLs or thehashtagsfield. - TikTok keyword search export: search results sorted by relevance, likes or date, from
keywordswithsortTypeanddateRange. - TikTok sound and music trend analysis: posts that use a sound, with
song.title,song.artistandsong.duration, from music URLs. - Regional TikTok trend research: results from one country, using
locationwith an ISO 3166-1 alpha-2 code. - TikTok competitor monitoring: a brand's recent posts inside a date window, using
profileSorting,oldestPostDateUnifiedandexcludePinnedPosts.
How Do You Use the TikTok Scraper API?
The TikTok Scraper API runs in 3 steps and needs only startUrls or keywords.
- Open the TikTok Scraper API in Apify Console.
- Enter TikTok URLs in
startUrlsor search terms inkeywords, and setmaxItems. - Run it and download the results as JSON, CSV or Excel, or read them through the Apify API.
{"startUrls": ["https://www.tiktok.com/@nike"],"maxItems": 20}
The input above returns up to 20 posts from the @nike profile for $0.006 in total, because the first 20 posts of a user query are included. One returned post looks like this:
{"inputSource": "https://www.tiktok.com/@nike","id": "7546234572208377101","title": "Why risk it? Because you can. #JustDoIt","views": 340916,"likes": 13939,"comments": 464,"shares": 812,"bookmarks": 1141,"hashtags": ["justdoit"],"channel": {"id": "208464585232822272","name": "Nike","username": "nike","verified": true,"url": "https://www.tiktok.com/@nike","followers": 7933653},"uploadedAt": 1756994667,"uploadedAtFormatted": "2025-09-04T14:04:27.000Z","postPage": "https://www.tiktok.com/@nike/video/7546234572208377101"}
When Should You Use the TikTok Scraper API?
The TikTok Scraper API is built for post-level TikTok data, not for comments, follower lists or video files.
Use it for:
- Bulk export of posts from many profiles, hashtags, searches, sounds or places in one run
- Engagement tracking on a schedule, comparing
views,likesandsharesbetween runs - Feeding TikTok post data to an AI agent or a data pipeline through the API or MCP
Use something else for:
- Comments and replies: use TikTok Comments Scraper.
- Follower and following lists: use TikTok User Scraper.
- Video file downloads: the TikTok Scraper API returns
video.urlbut does not save video files to storage.
How Much Does the TikTok Scraper API Cost?
The TikTok Scraper API charges 7 event types: $0.006 per user, search, hashtag or location query, $0.003 per music or single post query, and $0.0003 per post beyond the included posts.
| Event | Price | When it is charged |
|---|---|---|
user-query | $0.006 | Once per profile URL, username or user ID, at run start. Includes the first 20 posts |
search-query | $0.006 | Once per keyword or search URL, at run start. Includes the first 20 posts |
tag-query | $0.006 | Once per hashtag, at run start. Includes the first 20 posts |
location-query | $0.006 | Once per location URL, at run start. Includes the first 20 posts |
music-query | $0.003 | Once per music URL, at run start. Includes the first 10 posts |
single-post-query | $0.003 | Once per video, photo or short vm.tiktok.com URL. Returns 1 post, no item charge |
dataset-item | $0.0003 | Each post saved beyond the included posts |
Query events are charged when the run starts, for every source in the input. A run whose maximum cost per run cannot cover those query charges stops before scraping; on the Apify Free plan, that stopped run is also charged 10 dataset-item events. Posts removed by profile filters are never saved and never charged.
TikTok Scraper API Cost Examples
The table below prices 6 scenarios against the rate card above.
| Scenario | Charge events | Calculation | Total cost |
|---|---|---|---|
| 1 profile, 20 posts | 1 user-query | $0.006 | $0.006 |
| 1 profile, 100 posts | 1 user-query + 80 dataset-item | $0.006 + 80 × $0.0003 | $0.030 |
| 1 hashtag, 500 posts | 1 tag-query + 480 dataset-item | $0.006 + 480 × $0.0003 | $0.150 |
| 1 sound, 200 posts | 1 music-query + 190 dataset-item | $0.003 + 190 × $0.0003 | $0.060 |
| 5 single videos | 5 single-post-query | 5 × $0.003 | $0.015 |
| 10 keywords, 100 posts each | 10 search-query + 800 dataset-item | 10 × $0.006 + 800 × $0.0003 | $0.300 |
TikTok Scraper API Unit Economics
The 3 figures below are derived from the dataset-item price and exclude the per-query fee.
| Metric | Value |
|---|---|
| Cost per post | $0.0003 |
| Posts per $1 | 3,333 |
| Cost per 1,000 posts | $0.30 |
Does the TikTok Scraper API work on the Apify Free plan?
The TikTok Scraper API runs in demo mode on the Apify Free plan: 5 runs per month, each capped at 10 items. A paid Apify plan removes the cap. See Apify pricing.
How Is the TikTok Scraper API Configured?
The TikTok Scraper API accepts 23 input fields: 12 in the Console form and 11 that work through the API or the JSON input editor. Every source field is optional on its own, but the run needs at least one source.
| Field | Type | Required | Description | Default |
|---|---|---|---|---|
startUrls | array | One source required | TikTok profile, video, photo, search, tag, music, place or vm.tiktok.com URLs | |
keywords | array | One source required | Search terms, one search per keyword | |
maxItems | integer | No | Maximum total posts saved across the run. Paid plans only; Free plan runs use the 10-item demo cap instead | |
sortType | string | No | Search order: RELEVANCE, MOST_LIKED or DATE_POSTED. Applies to keywords only, not to search URLs in startUrls | |
dateRange | string | No | Search window for keywords and search URLs in startUrls: DEFAULT, ALL_TIME, YESTERDAY, THIS_WEEK, THIS_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS | |
location | string | No | ISO 3166-1 alpha-2 country code, from 249 codes. Sets the region for search, profile, video, music and location sources; for hashtags it is used only to look up the tag | |
includeSearchKeywords | boolean | No | Adds a keyword field with the search term that found each post | |
customMapFunction | string | No | A synchronous JavaScript function that transforms each post | |
outputConnector | string | No | MCP connector that receives the results (Notion, Todoist) | |
deliverTarget | string | No | URL or ID the connector writes to | |
deliverMode | string | No | perPost (one record per post) or summary (one record per run) | perPost |
deliverMaxItems | integer | No | Cap on records written in perPost mode | |
hashtags | array | API only | Hashtags, with or without # | |
profiles | array | API only | Usernames, with or without @, or numeric user IDs | |
postURLs | array | API only | Video and photo post URLs, added to startUrls | |
searchQueries | array | API only | Search terms, added to keywords | |
resultsPerPage | integer | API only | Maximum posts per source, from 1 to 1,000,000. Empty means no per-source limit | |
profileSorting | string | API only | Profile post order: latest or popular | latest |
excludePinnedPosts | boolean | API only | Drops pinned posts from profile results | false |
oldestPostDateUnified | string | API only | Profile posts on or after this date: 2025-01-31, or a period such as 7, 2 weeks, 3 months | |
newestPostDate | string | API only | Profile posts on or before this date, same formats; a plain date includes the whole day | |
leastDiggs | integer | API only | Profile posts with at least this many likes | |
mostDiggs | integer | API only | Profile posts with at most this many likes |
The TikTok Scraper API accepts 6 URL formats in startUrls.
| Source | URL format |
|---|---|
| Profile | https://www.tiktok.com/@username |
| Video or photo | https://www.tiktok.com/@username/video/ID |
| Search | https://www.tiktok.com/search?q=keyword |
| Hashtag | https://www.tiktok.com/tag/hashtag |
| Music | https://www.tiktok.com/music/name-ID |
| Location | https://www.tiktok.com/place/name-ID |
Which Input Rules Does the TikTok Scraper API Enforce?
The TikTok Scraper API enforces 8 input rules covering sources, sorting, filters and field aliases.
- One source is required. A run with no
startUrls,keywords,hashtags,profiles,postURLsorsearchQueriesfails withSearch keywords or start URLs must be provided. - Invalid URLs are skipped. A URL outside
tiktok.comor in an unsupported format is logged as a warning and does not stop the run. - Search settings have different scopes.
sortTypeapplies tokeywordsonly;dateRangeapplies tokeywordsand search URLs. Profiles useprofileSorting. profileSortingoldestfalls back tolatest. The log says so.popularsorting ignores date filters. The likes range then applies.- A date filter disables the likes range. With
latestsorting,leastDiggsandmostDiggsare ignored when a date filter is set. - Date windows stop pagination early. With
latestsorting, the run stops paging a profile once it reaches posts older thanoldestPostDateUnified, so pages outside the window are not fetched. - Sources from alternative fields are not duplicated. A hashtag in
hashtagsand the same tag URL instartUrlsare scraped and charged once. The same entry written twice instartUrlsorkeywordsruns, and is charged, twice.
The TikTok Scraper API also reads 3 field names used by other TikTok scrapers: videoSearchSorting maps to sortType, videoSearchDateFilter maps to dateRange, and proxyCountryCode maps to location. Native fields win when both are set. Unsupported fields such as shouldDownloadVideos or commentsPerPost are listed in the run log and ignored, never failing the run.
Which Fields Does the TikTok Scraper API Return?
The TikTok Scraper API returns one dataset item per post, with post, engagement, creator, video and sound fields.
| Field | Type | Description |
|---|---|---|
inputSource | string | The URL, keyword or user ID that produced the post |
id | string | TikTok post ID |
title | string | Post caption |
views | number | View count |
likes | number | Like count |
comments | number | Comment count |
shares | number | Share count |
bookmarks | number | Save count |
hashtags | array | Hashtags in the post |
uploadedAt | number | Upload time, Unix seconds |
uploadedAtFormatted | string | Upload time, ISO 8601 |
postPage | string | Post URL |
channel | object | Creator: id, name, username, bio, avatar, verified, url, followers, following, videos |
video | object | Video: width, height, ratio, duration, url, cover, thumbnail |
song | object | Sound: id, title, artist, album, duration, cover |
subtitleInformation | array | Caption tracks with language, format and URL |
keyword | string | Search term, when includeSearchKeywords is true |
How Do You Track TikTok Hashtags with the TikTok Scraper API?
The TikTok Scraper API takes a list of hashtags and returns the posts under each one. Each tag costs one tag-query, which includes its first 20 posts.
{"hashtags": ["skincare", "#booktok"],"resultsPerPage": 100,"maxItems": 200}
How Do You Search TikTok by Keyword with the TikTok Scraper API?
The TikTok Scraper API runs one TikTok search per keyword, limited to the country and time window you set. Turn on includeSearchKeywords to see which term found each post.
{"keywords": ["protein recipes", "meal prep"],"sortType": "MOST_LIKED","dateRange": "THIS_MONTH","location": "US","includeSearchKeywords": true,"maxItems": 300}
How Do You Monitor TikTok Profiles with the TikTok Scraper API?
The TikTok Scraper API returns each creator's recent posts and skips pinned ones. With latest sorting, paging stops at the first post older than the window, so a weekly run fetches only new pages.
{"profiles": ["gordonramsayofficial", "@billieeilish"],"profileSorting": "latest","oldestPostDateUnified": "7","excludePinnedPosts": true,"resultsPerPage": 50}
How Do You Transform Output with the TikTok Scraper API?
The TikTok Scraper API applies customMapFunction to each post to add or remove fields. The function below adds an engagement rate and drops the video and song objects.
{"startUrls": ["https://www.tiktok.com/@nike"],"customMapFunction": "(object) => ({ ...object, engagementRate: ((object.likes + object.comments + object.shares) / object.views * 100).toFixed(2), video: undefined, song: undefined })"}
The function runs in a sandbox under 7 rules:
- One synchronous function expression;
asyncand generator functions are rejected. - It returns an object for every post.
- No
new Date,Date.nowor1970; useuploadedAtFormattedfor dates. - Plain JavaScript only: no network access,
requireorconsole. - About 1 second per post.
- It transforms posts and is not meant for filtering them; filtering in this function can trigger automatic restrictions.
- A rejected function is disabled with a warning that starts
Your "customMapFunction" input was rejected:, and the original posts are saved. The run continues.
Which Errors Does the TikTok Scraper API Report?
The TikTok Scraper API reports 34 error codes in the run log. 31 of the 34 codes are non-terminal: they skip one source or page and the run continues. 3 codes (C098, C099, C100) stop the run and ask you to contact support with the run ID.
| Codes | Meaning | What to do | Charged |
|---|---|---|---|
C022 to C030 | Source not found: post, user, tag, music, place or keyword returned nothing | Check the URL or username | The query event is charged at run start |
C001 to C020 | A request for a source or page failed after retries | Run that source again | The query event is charged at run start |
C021 | Rate limit reached for your account; an item with error: true and code: "C021" is saved | Contact the developer for more capacity | No item charge for the error item |
C201 | Delivery to the MCP connector failed | Check the connector and target; results stay in the dataset | No |
C098, C099, C100 | Unexpected run error | Contact support with the run ID | Charges made before the error stay |
How Do You Schedule or Integrate the TikTok Scraper API?
The TikTok Scraper API connects to 4 kinds of tools: the Apify API, the Apify MCP server, MCP connectors and Apify integrations.
- Schedules: save the input as a task and run it daily for hashtag tracking or weekly for profile monitoring with
oldestPostDateUnifiedset to7. - API: start runs and read datasets from Python, JavaScript or any HTTP client through the Apify API and Apify client libraries.
- AI agents (MCP): add
https://mcp.apify.com/?tools=apidojo/tiktok-scraper-apias a remote MCP server. - MCP connectors: set
outputConnectorto a Notion or Todoist connector authorized in Console, under Settings, API & Integrations, MCP connectors. PointingdeliverTargetat a Notion page builds a database with one typed column per field. Delivery runs after the scrape, uses only non-destructive write tools, and a delivery failure never fails the run. - No-code tools and webhooks: Make, Zapier, n8n and webhooks through Apify integrations.
Which TikTok Scraper API Questions Come Up Most Often?
Is the TikTok Scraper API free?
No, but the Apify Free plan runs it in demo mode: 5 runs per month, 10 items per run. On a paid plan, the first 20 posts of each profile, search, hashtag and location query, and the first 10 of each music query, are included in the query fee.
How much does it cost to scrape 1,000 TikTok posts?
One profile with 1,000 posts costs $0.300: $0.006 for the user-query and 980 × $0.0003 = $0.294 for the posts beyond the first 20.
Do you need a TikTok account to use the TikTok Scraper API?
No. The TikTok Scraper API takes no TikTok login, cookies or API key as input.
How is the TikTok Scraper API different from the official TikTok API?
The TikTok Scraper API needs no TikTok developer app or approval. It returns public post data from URLs, usernames, hashtags and keywords as a downloadable dataset.
Can the TikTok Scraper API scrape TikTok comments?
No. The TikTok Scraper API returns the comments count per post. For comment text and replies, use TikTok Comments Scraper.
Can the TikTok Scraper API download TikTok videos?
No. Each post includes video.url, video.cover and video.thumbnail, but files are not saved to storage. shouldDownloadVideos is accepted and ignored.
Can I get TikTok data from a specific country?
Yes. Set location to an ISO 3166-1 alpha-2 code such as US, GB or DE. It sets the region for search, profile, video, music and location sources; hashtag sources use it only to look up the tag.
How do I get only recent posts from a TikTok profile?
Set oldestPostDateUnified to a date or a period such as 30. With latest sorting, the TikTok Scraper API stops paging at the first older post, so you pay only for posts inside the window.
Why does the TikTok Scraper API return fewer posts than expected?
maxItems, resultsPerPage, profile filters and the maximum cost per run each cap the output. Search also stops early when 3 pages in a row each add only 1 to 4 new posts.
Can I reuse input from another TikTok scraper?
Yes. hashtags, profiles, postURLs, searchQueries, videoSearchSorting, videoSearchDateFilter and proxyCountryCode are mapped to TikTok Scraper API fields, and unknown fields are ignored.
How can I use the TikTok Scraper API from Python?
Install apify-client, call the actor with your input, and read the run's dataset items. The same works from JavaScript and any HTTP client.
Is it legal to scrape TikTok?
The TikTok Scraper API collects publicly available data. Your use of it is subject to TikTok's terms of service and to data protection law, including GDPR when posts contain personal data. Get legal advice for your specific use case.
Related Actors
The 5 actors below work alongside the TikTok Scraper API.
- TikTok Comments Scraper: collects comments and replies for the post URLs the TikTok Scraper API returns in
postPage. - TikTok User Scraper: collects follower and following lists for creators found in
channel.username. - TikTok Profile Scraper: focuses on profile posts and follower counts for creator analytics.
- TikTok Hashtag Scraper: focuses on posts under a hashtag for campaign tracking.
- TikTok Music Scraper: focuses on posts that use a sound for audio trend analysis.
Support
Open an issue on the TikTok Scraper API's Issues tab, or email apidojo10@gmail.com.