TikTok Search Results, Parsed Through an API
TikTok search pages are heavy, JavaScript-driven and quick to change.
This page describes a managed scraping API that accepts a TikTok search URL and returns video metadata, view counts, engagement signals, hashtags, sound tags and creator info as structured JSON or rendered HTML. The sections below explain what you get, how requests are priced in credits, and where the practical limits sit so you can decide whether this fits your pipeline.
What a TikTok search request returns
Each search result can carry video metadata, view counts, like counts, comment counts, share counts, hashtags, sound tags and creator info. You choose the output shape: structured JSON for direct parsing, or rendered HTML if your existing pipeline already handles markup. The API handles proxy rotation, browser rendering and anti-bot measures on its side, so your code sends a URL and an API key rather than managing headless browsers.
Typical uses include collecting hashtags for content discovery, identifying trending sounds, and comparing engagement per result. Because the response is already parsed, downstream work focuses on analysis rather than selector maintenance.
Request options and what each one costs
The request model is a base call plus optional parameters. The table below maps the main options to their effect and credit cost. Credit costs are per successful request and depend on which options are enabled; the numbers are the captured contract values, not estimates.
| Option | Effect | Credit cost |
|---|---|---|
| Base request | Fetch and parse a TikTok search URL | Starts at 1 credit |
render_js | Enable JavaScript rendering | 5 credits |
premium_proxy with JS rendering | Premium proxies plus rendering | 25 credits |
stealth_proxy | Stealth proxy for harder targets | 75 credits |
country_code | Geo-target the request | Cost not specified |
extract_rules | CSS selectors mapped to field names | Cost not specified |
ai_extract_rules | Natural-language extraction spec | Cost not specified |
The base request starts at 1 credit, and the three priced options add 5, 25 or 75 credits per successful request. Geo-targeting, extraction rules and AI extraction rules are plan features; their per-request credit cost is not stated, so confirm it before estimating volume.
How a request flows
- Create an account to receive an API key and the free starting credits.
- Install an SDK for Python, Node.js, Go, PHP, Ruby or Java, or use plain cURL.
- Send one HTTP request containing your API key and the TikTok search URL.
- Add advanced parameters only when needed:
render_jsfor JavaScript,stealth_proxyfor CAPTCHA-heavy pages,country_codefor geo-targeting, andai_extract_rulesfor natural-language extraction. - Receive a clean response ready to parse.
The SDKs turn each scrape into a single function call, so proxy rotation and headless browser management stay out of your codebase.
Decision checklist before you build
Use this checklist to confirm the API fits your task before writing integration code.
- Confirm the target pages are public search results, not post-login content.
- Decide whether you need JSON or rendered HTML; JSON avoids a parsing layer.
- Estimate monthly request volume and multiply by the credit cost of the options you will enable.
- Check that your plan's concurrency limit matches your peak parallelism.
- Confirm whether you need geo-targeting or AI extraction rules, since those are plan features.
- Review the target site's terms of service before deploying.
- Plan a retry and backoff strategy for target-side throttling, which is separate from your plan's concurrency limit.
Worked credit example
Suppose you run 1,000 searches per month with JavaScript rendering enabled and no premium or stealth proxy. At 5 credits per successful request, that is 5,000 credits. If you instead need premium proxies with JS rendering at 25 credits per request, the same 1,000 searches consume 25,000 credits. Stealth proxy requests at 75 credits each would consume 75,000 credits for the same volume.
This example uses only the captured per-request credit values. It does not assume a plan price or a discount; check the current plan table for the credit allowance that matches your volume.
Two different throttling problems
There are two separate limits to watch. The first is your plan's concurrency limit, which caps how many requests can be in flight at once. The second is target-side throttling, where TikTok itself may slow or block aggressive request patterns even when your plan allows more concurrency.
If requests fail with concurrency errors, reduce parallelism or upgrade the plan. If requests succeed at low volume but degrade under load, the target is likely throttling you; spacing out requests or using multiple sessions is the documented mitigation. Treating these as the same problem leads to unnecessary upgrades or ineffective retries.
Output formats and integration paths
The API can return structured JSON, rendered HTML or clean Markdown depending on the parameters you set. JSON is the default fit for analytics pipelines; Markdown is useful when feeding results into an LLM for trend tracking or content research. Screenshots are available for visual verification, and JavaScript scenarios let you click, scroll or wait for dynamic content before extraction.
For teams that prefer no-code automation, the same API can be called from n8n workflows to run trend-monitoring jobs without scraper code.
Plan context
The plan table below shows the published tiers, from the entry-level standard plan through the largest enterprise option, with API credit allowances and concurrency limits increasing at each step. Treat the figures as a reference point rather than a permanent quote: pricing, credit allowances and concurrency ceilings are subject to change, and any applicable tax treatment depends on your billing location. Before committing to a tier, confirm the current price list and the credit allowance that matches your expected monthly request volume.
| Plan | Price | API credits | Concurrent requests | Priority support | Account manager | Team management |
|---|---|---|---|---|---|---|
| Hobby | $19 /mo | 75,000 | 25 | Not included | Not included | Not included |
| Freelance | $49 /mo | 250,000 | 50 | Not included | Not included | Not included |
| Startup (Recommended) | $99 /mo | 1,000,000 | 100 | Not included | Not included | Not included |
| Business | $249 /mo | 3,000,000 | 200 | Included | Included | Included |
| Business + | $599 /mo | 8,000,000 | 400 | Included | Included | Included |
| Enterprise 14 | $999 /mo | 14,000,000 | 500 | Included | Included | Included |
| Enterprise 24 | $1,599 /mo | 24,000,000 | 600 | Included | Included | Included |
| Enterprise 41 (Recommended) | $2,399 /mo | 41,000,000 | 700 | Included | Included | Included |
| Enterprise 69 | $3,599 /mo | 69,000,000 | 800 | Included | Included | Included |
| Enterprise 120 | $5,799 /mo | 120,000,000 | 900 | Included | Included | Included |
Credit allowances and concurrency are per plan as listed; prices, allowances and tax treatment can change, so confirm current terms before purchase.
Frequently asked questions
Do I need a TikTok account to use this scraper?
No TikTok account is required. You register for an API key, then send the search URL and the API handles the rest. Whether a free starting credit allowance applies, and how large it is, depends on the current signup terms, so check those before you begin.
Is scraping TikTok search results legal?
Public-facing pages can usually be scraped, but review the target site's terms of service before deploying and avoid post-login content. Legal position varies by jurisdiction and use case.
Is there a rate limit per target?
The API enforces concurrency limits per plan rather than per-target rate limits. If TikTok throttles aggressive patterns, space out requests or use multiple sessions.
How do I get structured JSON from TikTok search?
Two extraction modes both end in parsed JSON. With extract_rules, you supply a mapping in which every CSS selector is tied to the output field name it should populate. With ai_extract_rules, you instead write a plain-language description of the fields you want. Whichever mode you pick, the reply arrives already parsed as JSON, so no HTML parser of your own is needed.
Which languages can I use?
Any language that can send an HTTP request. SDKs are published for Python, Node.js, Go, PHP, Ruby and Java, and plain cURL works too.
How much does a TikTok search scrape cost?
Paid plans start at $19/month, and the per-request credit cost depends on which options you enable: 5 credits for JS rendering, 25 for premium proxy with JS, and 75 for stealth proxy. Any free starting credits, and the exact allowance attached to each plan, follow the current published terms rather than a fixed promise.