TikTok scraper: what works, what breaks, and when to skip it

A TikTok scraper calls TikTok's web and app endpoints and turns the JSON into rows. If you'd rather not run one, TokConnect returns most of the same public data (videos, creators, comments, hashtags) plus TikTok's own search counts: ask its research agent, or use the same data inside ChatGPT, Claude and Cursor through its MCP server. If you do want a scraper, the most used hosted one, Apify's Clockworks TikTok Scraper, costs $3.70 per 1,000 results on Apify's free plan, and the free code most tutorials link to has not had a code push since May 2023.

Most of the work in a TikTok scraper is not the scraping. It is the signature layer, the proxy pool and the parser you rewrite when a field is renamed, because TikTok signs, rate-limits and challenges requests and bans accounts that trip the checks. Whether you should run one depends on what you are collecting.

Share or embed this infographic

Free to use on your site, in a deck or a newsletter with a credit link to TokConnect. Copy the code below.

<a href="https://tokconnect.com/guides/tiktok-scraper/"><img src="https://tokconnect.com/graphics/tiktok-scraper/summary.png" alt="TikTok scrapers in 2026, what they cost and what keeps them alive: $3.70 per 1,000 results for Apify&#x27;s top TikTok actor on its free plan; $1.50 per 1,000 records at Bright Data after 5,000 free a month; 308K total users of Apify&#x27;s Clockworks TikTok Scraper; May 2023, the last code push to drawrowfly/tiktok-scraper (5.2K stars)" width="1200" height="630" style="max-width:100%;height:auto"></a><br>Source: <a href="https://tokconnect.com/guides/tiktok-scraper/">TikTok Scraper: What Works, What Breaks (2026)</a> on TokConnect

Copy embed codeDownload PNG

What does a TikTok scraper do?

Every option on this page, hosted or free, does the same four things.

1. Builds a signed request. TikTok's endpoints require signature parameters generated from the request and a device fingerprint. Getting these right is the hard part and the reason abandoned projects stop working.
2. Routes it through an exit. Data-center IPs get challenged fast, so serious scrapers use residential proxies and rotate them.
3. Parses an undocumented response. These are private endpoints. Field names change without notice.
4. Handles the block. An empty 200, a captcha, or a slow throttle, each needing different backoff.

Tools differ mainly in which of those four you pay someone else to do.

The tools, compared

Checked 5 October 2026: Apify prices and usage from Apify's public API, Bright Data and HasData from their own pages (HasData's price), GitHub figures from the GitHub API. ScraperAPI and the browser extensions are described from their own pages and have no per-record price. Apify, HasData and TokConnect costs per 1,000 results are compared in HasData vs Apify vs TokConnect.

If you are searching for "tiktok scraper python" and hoping for a pip install that just works, the short version is that the library is free and the proxies are not. Budget for both.

Skip the scraper: get a free API key

Why do TikTok scrapers break?

• Signatures. When TikTok changes how requests are signed, every scraper that generates them breaks at once. Maintained projects ship a fix in days. Unmaintained ones never do, which is what happened to a lot of the GitHub code still ranking for this query.
• Captchas and empty responses. TikTok's block signal is often a 200 with nothing in it rather than an error. Code that assumes an empty list means "no results" will quietly report that a topic has no videos.
• Rate limits. Aggressive paging from one exit gets throttled, then challenged, then blocked. This is why hosted actors charge per record: you are buying the proxy pool.
• Account bans. Anything that scrapes from a logged-in session puts that account at risk. Never point a scraper at an account you care about.
• Silent shape changes. A renamed field does not raise an error. It produces a column of nulls that nobody notices until someone builds a chart on it.

Is scraping TikTok legal?

"How legal is scraping TikTok" comes up on r/DataHoarder and r/webscraping every few months, and the answer has four parts: a contract, a line of US cases, privacy law, and what enforcement looks like in practice.

The contract. TikTok's Terms of Service prohibit scraping, crawling or extracting data from the platform with any automated system, bots included, unless TikTok has approved it in writing. You agree to that by using the service. Breaching it can cost you accounts and API access, and since hiQ it is also the ground platforms sue on.

The US cases. hiQ Labs v. LinkedIn is the one people cite. hiQ scraped public LinkedIn profiles, LinkedIn tried to stop it, and in 2019 and again in April 2022 the Ninth Circuit held that scraping pages anyone can see without logging in is probably not access without authorization under the Computer Fraud and Abuse Act. That is the good news for scrapers, and it is where most summaries stop.

The rest: in November 2022 the district court found hiQ had breached LinkedIn's user agreement, and in December 2022 the case ended in a consent judgment that permanently bars hiQ from scraping LinkedIn, requires it to destroy the scraped data and the code built on it, and carries a $500,000 judgment. Public data may sit outside the CFAA; the terms you clicked through are still a contract.

Personal data. Handles, faces, voices and comments are personal data, and the law does not care how you collected them. Data protection authorities including the UK's ICO said in a 2023 joint statement that publicly accessible personal information is still covered by privacy law in most jurisdictions, and the EDPB's 2026 web scraping guidelines, written for AI training, say the same under GDPR: you need a lawful basis, a stated purpose and a privacy notice whether or not the profile was public.

UK GDPR follows suit. California is narrower: the CCPA excludes information a consumer lawfully made available to the general public, but not biometric data collected without their knowledge and not posts restricted to a specific audience. Storing and republishing what you scraped is where these obligations land, and they have nothing to do with TikTok.

The sanctioned route. The Research API exists for exactly this. Academic institutions in the US, EEA, UK and Switzerland, EU non-profit research bodies and Brazilian youth-safety researchers can apply for public video, comment and account data with a documented schema, on a not-for-profit basis. TikTok publishes no firm review time; a September 2026 guide by Xpoz reports weeks to months. If you qualify, use it. The Research API guide covers the application.

What enforcement looks like. Almost all of it is technical. TikTok answers scrapers with signature changes, captchas, empty responses, rate limits and account bans, not letters from lawyers. The r/DataHoarder answer that gets upvoted is that you will be blocked long before anyone tracks you down, and for a hobby project that is about right. The exceptions are commercial scale and personal data, which is where the contract and the privacy law start to matter, and where you ask a lawyer before you ask an engineer.

When is scraping the right choice?

It genuinely is, sometimes.

• You need the video files or covers themselves, not metadata.
• You need a field nobody exposes through an API, like subtitle text or a specific Shop attribute.
• You are collecting at a volume where per-record pricing stops making sense and running your own pool is cheaper.
• It is a one-off. Scrape it, use it, throw the code away, and do not pretend it is infrastructure.

Scraping is also a popular TikTok topic in its own right. Here are the most-played of the 20 most-liked TikTok videos for "web scraping" on 5 October 2026. The top one is about how sites block scrapers:

Twelve of the 20 were posted in 2026, and several push new open-source tools. That churn is the point: the tool that works this quarter is rarely the one a 2023 tutorial recommends.

It is the wrong tool when you want an answer rather than a dataset. "What are people searching for in my niche" is not a scraping problem, and you will spend three weeks on proxies to find out that the number you wanted was never on a page. Pick TokConnect for that: it returns TikTok's own search counts.

The routes that need no scraper

Two of them.

Official APIs. If you are an academic, the Research API gives you keyword video search and comments, free, with a documented schema and 1,000 requests a day. If you are building a product, Login Kit, Display, Content Posting, the Business APIs and TikTok Shop each cover their own job. Our map of every TikTok API says which one does what, and the Research API guide covers the application.

TokConnect. This is the newer option. TokConnect handles the request layer for you and exposes TikTok as tools an agent or a script can call: video, creator, hashtag and sound search, autocomplete, video detail, comments and replies, plus Creator Search Insights topics with their 7-day search volumes and content-gap flags. The endpoint is https://mcp.tokconnect.com/mcp with your key sent as Authorization: Bearer YOUR_TOKCONNECT_KEY, and keys are free. You start with 50 free credits, then paid plans run from $34.99 a month billed yearly (500 credits a month); one credit buys one lookup, and failed lookups are free. Every paid plan also includes a REST API: see the API docs.

Get a free API key Paid plans from $34.99 a month

Here is the no-scraper version of "search TikTok and print the results", with pip install mcp:

import asyncio, json, os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

URL, AUTH = "https://mcp.tokconnect.com/mcp", {
    "Authorization": f"Bearer {os.environ['TOKCONNECT_KEY']}"}

async def search(keyword, limit=20):
    async with streamablehttp_client(URL, headers=AUTH) as (r, w, _):
        async with ClientSession(r, w) as s:
            await s.initialize()
            res = await s.call_tool("video_search", {
                "keyword": keyword, "limit": limit, "sort": "most_liked"})
            return json.loads(res.content[0].text)["videos"]

for v in asyncio.run(search("mechanical keyboard")):
    print(f'{v["playCount"]:>10,} views  @{v["authorUniqueId"]:<20} '
          f'{v["desc"][:55]}')

import httpx2
from mcp.client.streamable_http import streamable_http_client

async with streamable_http_client(URL, http_client=httpx2.AsyncClient(headers={"Authorization": f"Bearer {KEY}"})) as (read, write):
    async with ClientSession(read, write) as session:
        ...

No Playwright, no ms_token, no proxy list. A real two-page run of that search is saved as a snapshot, and the search API guide explains the paging.

It also covers jobs people often build a scraper for. It turns a video's existing TikTok captions into a timed transcript (try the free transcript generator). It also draws giveaway winners from a video's comments. For TikTok Shop, no scraper can see sales over time, because a listing only shows a lifetime sold count. TokConnect's best-seller rankings for products and shops return estimated revenue and units for TikTok Shop, in the US by default or 16 other markets, over any date range. Choosing between MCP servers rather than scrapers? See nine TikTok MCP servers compared.

How we got these numbers

Tool prices and usage were: Apify's figures from its public API for the Clockworks actor (pricing tiers, total users, 30-day public runs and successful runs), Bright Data and HasData from their own product and docs pages, and GitHub stars, open issues and last push dates from the GitHub API. Older facts that we could not re-check that day are dated in the table note.

The video data was pulled through TokConnect's MCP server with one video search for "web scraping", 20 results sorted by likes. Plays and likes are TikTok's public totals that day, worldwide; creator handles and media links were stripped before saving. Data: video snapshot, Apify and HasData facts, paging example, TokConnect tool catalog, 20 October 2026.