Fast TikTok Scraper API | Influencer Data & Analytics API avatar

Fast TikTok Scraper API | Influencer Data & Analytics API

Pricing

from $0.30 / 1,000 tiktok post items

Go to Apify Store
Fast TikTok Scraper API | Influencer Data & Analytics API

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

API Dojo

Maintained by Apify Partner

Actor stats

35

Bookmarked

1.5K

Total users

245

Monthly active users

5.3 hours

Issues response

6 hours ago

Last modified

Features

Limited permissions

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.

InputTikTok 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 postsOn 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
OutputOne dataset item per post: id, title, views, likes, comments, shares, bookmarks, hashtags, channel, video, song, subtitleInformation, postPage
FormatsJSON, CSV, Excel, XML, HTML, RSS (Apify dataset export)
FiltersRegion (location, 249 country codes), search date range and sorting, profile sorting, date window, likes range and pinned posts
LimitsmaxItems caps the run on paid plans (Free plan: 10 items); resultsPerPage caps each source (1 to 1,000,000)
Agent accessApify 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, likes and channel.followers, from profile URLs or the profiles field.
  • TikTok hashtag tracking: posts under a tag with their engagement counts, from https://www.tiktok.com/tag/{hashtag} URLs or the hashtags field.
  • TikTok keyword search export: search results sorted by relevance, likes or date, from keywords with sortType and dateRange.
  • TikTok sound and music trend analysis: posts that use a sound, with song.title, song.artist and song.duration, from music URLs.
  • Regional TikTok trend research: results from one country, using location with an ISO 3166-1 alpha-2 code.
  • TikTok competitor monitoring: a brand's recent posts inside a date window, using profileSorting, oldestPostDateUnified and excludePinnedPosts.

How Do You Use the TikTok Scraper API?

The TikTok Scraper API runs in 3 steps and needs only startUrls or keywords.

  1. Open the TikTok Scraper API in Apify Console.
  2. Enter TikTok URLs in startUrls or search terms in keywords, and set maxItems.
  3. 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, likes and shares between 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.url but 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.

EventPriceWhen it is charged
user-query$0.006Once per profile URL, username or user ID, at run start. Includes the first 20 posts
search-query$0.006Once per keyword or search URL, at run start. Includes the first 20 posts
tag-query$0.006Once per hashtag, at run start. Includes the first 20 posts
location-query$0.006Once per location URL, at run start. Includes the first 20 posts
music-query$0.003Once per music URL, at run start. Includes the first 10 posts
single-post-query$0.003Once per video, photo or short vm.tiktok.com URL. Returns 1 post, no item charge
dataset-item$0.0003Each 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.

ScenarioCharge eventsCalculationTotal cost
1 profile, 20 posts1 user-query$0.006$0.006
1 profile, 100 posts1 user-query + 80 dataset-item$0.006 + 80 × $0.0003$0.030
1 hashtag, 500 posts1 tag-query + 480 dataset-item$0.006 + 480 × $0.0003$0.150
1 sound, 200 posts1 music-query + 190 dataset-item$0.003 + 190 × $0.0003$0.060
5 single videos5 single-post-query5 × $0.003$0.015
10 keywords, 100 posts each10 search-query + 800 dataset-item10 × $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.

MetricValue
Cost per post$0.0003
Posts per $13,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.

FieldTypeRequiredDescriptionDefault
startUrlsarrayOne source requiredTikTok profile, video, photo, search, tag, music, place or vm.tiktok.com URLs
keywordsarrayOne source requiredSearch terms, one search per keyword
maxItemsintegerNoMaximum total posts saved across the run. Paid plans only; Free plan runs use the 10-item demo cap instead
sortTypestringNoSearch order: RELEVANCE, MOST_LIKED or DATE_POSTED. Applies to keywords only, not to search URLs in startUrls
dateRangestringNoSearch window for keywords and search URLs in startUrls: DEFAULT, ALL_TIME, YESTERDAY, THIS_WEEK, THIS_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS
locationstringNoISO 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
includeSearchKeywordsbooleanNoAdds a keyword field with the search term that found each post
customMapFunctionstringNoA synchronous JavaScript function that transforms each post
outputConnectorstringNoMCP connector that receives the results (Notion, Todoist)
deliverTargetstringNoURL or ID the connector writes to
deliverModestringNoperPost (one record per post) or summary (one record per run)perPost
deliverMaxItemsintegerNoCap on records written in perPost mode
hashtagsarrayAPI onlyHashtags, with or without #
profilesarrayAPI onlyUsernames, with or without @, or numeric user IDs
postURLsarrayAPI onlyVideo and photo post URLs, added to startUrls
searchQueriesarrayAPI onlySearch terms, added to keywords
resultsPerPageintegerAPI onlyMaximum posts per source, from 1 to 1,000,000. Empty means no per-source limit
profileSortingstringAPI onlyProfile post order: latest or popularlatest
excludePinnedPostsbooleanAPI onlyDrops pinned posts from profile resultsfalse
oldestPostDateUnifiedstringAPI onlyProfile posts on or after this date: 2025-01-31, or a period such as 7, 2 weeks, 3 months
newestPostDatestringAPI onlyProfile posts on or before this date, same formats; a plain date includes the whole day
leastDiggsintegerAPI onlyProfile posts with at least this many likes
mostDiggsintegerAPI onlyProfile posts with at most this many likes

The TikTok Scraper API accepts 6 URL formats in startUrls.

SourceURL format
Profilehttps://www.tiktok.com/@username
Video or photohttps://www.tiktok.com/@username/video/ID
Searchhttps://www.tiktok.com/search?q=keyword
Hashtaghttps://www.tiktok.com/tag/hashtag
Musichttps://www.tiktok.com/music/name-ID
Locationhttps://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.

  1. One source is required. A run with no startUrls, keywords, hashtags, profiles, postURLs or searchQueries fails with Search keywords or start URLs must be provided.
  2. Invalid URLs are skipped. A URL outside tiktok.com or in an unsupported format is logged as a warning and does not stop the run.
  3. Search settings have different scopes. sortType applies to keywords only; dateRange applies to keywords and search URLs. Profiles use profileSorting.
  4. profileSorting oldest falls back to latest. The log says so.
  5. popular sorting ignores date filters. The likes range then applies.
  6. A date filter disables the likes range. With latest sorting, leastDiggs and mostDiggs are ignored when a date filter is set.
  7. Date windows stop pagination early. With latest sorting, the run stops paging a profile once it reaches posts older than oldestPostDateUnified, so pages outside the window are not fetched.
  8. Sources from alternative fields are not duplicated. A hashtag in hashtags and the same tag URL in startUrls are scraped and charged once. The same entry written twice in startUrls or keywords runs, 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.

FieldTypeDescription
inputSourcestringThe URL, keyword or user ID that produced the post
idstringTikTok post ID
titlestringPost caption
viewsnumberView count
likesnumberLike count
commentsnumberComment count
sharesnumberShare count
bookmarksnumberSave count
hashtagsarrayHashtags in the post
uploadedAtnumberUpload time, Unix seconds
uploadedAtFormattedstringUpload time, ISO 8601
postPagestringPost URL
channelobjectCreator: id, name, username, bio, avatar, verified, url, followers, following, videos
videoobjectVideo: width, height, ratio, duration, url, cover, thumbnail
songobjectSound: id, title, artist, album, duration, cover
subtitleInformationarrayCaption tracks with language, format and URL
keywordstringSearch 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; async and generator functions are rejected.
  • It returns an object for every post.
  • No new Date, Date.now or 1970; use uploadedAtFormatted for dates.
  • Plain JavaScript only: no network access, require or console.
  • 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.

CodesMeaningWhat to doCharged
C022 to C030Source not found: post, user, tag, music, place or keyword returned nothingCheck the URL or usernameThe query event is charged at run start
C001 to C020A request for a source or page failed after retriesRun that source againThe query event is charged at run start
C021Rate limit reached for your account; an item with error: true and code: "C021" is savedContact the developer for more capacityNo item charge for the error item
C201Delivery to the MCP connector failedCheck the connector and target; results stay in the datasetNo
C098, C099, C100Unexpected run errorContact support with the run IDCharges 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 oldestPostDateUnified set to 7.
  • 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-api as a remote MCP server.
  • MCP connectors: set outputConnector to a Notion or Todoist connector authorized in Console, under Settings, API & Integrations, MCP connectors. Pointing deliverTarget at 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.

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.

The 5 actors below work alongside the TikTok Scraper API.

Support

Open an issue on the TikTok Scraper API's Issues tab, or email apidojo10@gmail.com.