Skip to content

TikTok Search Results, Parsed Through an API

TikTok search pages are heavy, JavaScript-driven and quick to change.

OUTPUT FORMATSHTMLJSONMarkdown

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.

OptionEffectCredit cost
Base requestFetch and parse a TikTok search URLStarts at 1 credit
render_jsEnable JavaScript rendering5 credits
premium_proxy with JS renderingPremium proxies plus rendering25 credits
stealth_proxyStealth proxy for harder targets75 credits
country_codeGeo-target the requestCost not specified
extract_rulesCSS selectors mapped to field namesCost not specified
ai_extract_rulesNatural-language extraction specCost 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

  1. Create an account to receive an API key and the free starting credits.
  2. Install an SDK for Python, Node.js, Go, PHP, Ruby or Java, or use plain cURL.
  3. Send one HTTP request containing your API key and the TikTok search URL.
  4. Add advanced parameters only when needed: render_js for JavaScript, stealth_proxy for CAPTCHA-heavy pages, country_code for geo-targeting, and ai_extract_rules for natural-language extraction.
  5. 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.

Captured plan reference
PlanPriceAPI creditsConcurrent requestsPriority supportAccount managerTeam management
Hobby$19 /mo75,00025Not includedNot includedNot included
Freelance$49 /mo250,00050Not includedNot includedNot included
Startup (Recommended)$99 /mo1,000,000100Not includedNot includedNot included
Business$249 /mo3,000,000200IncludedIncludedIncluded
Business +$599 /mo8,000,000400IncludedIncludedIncluded
Enterprise 14$999 /mo14,000,000500IncludedIncludedIncluded
Enterprise 24$1,599 /mo24,000,000600IncludedIncludedIncluded
Enterprise 41 (Recommended)$2,399 /mo41,000,000700IncludedIncludedIncluded
Enterprise 69$3,599 /mo69,000,000800IncludedIncludedIncluded
Enterprise 120$5,799 /mo120,000,000900IncludedIncludedIncluded

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.