Social Media · TikTok Scraper
TikTok Top Search Scraper API
Pull TikTok's blended top results for a query, the mix of videos, users and sounds the app itself puts above the fold. No headless browsers, no captchas, proxies included.
// TikTok · Top Search
curl -H "X-API-Key: hpx_your_key_here" \
"https://hproxy.com/api/v1/scrape/tiktok/search-top?query=coffee"
// → { "data": { … }, "records": 1, "costUsd": … }
From Request to Clean JSON
You write one line. We do everything between the request and the data.
You send
One API call
GET the TikTok endpoint with your key. That's all your code does.
We handle
Proxies · captchas · parsing
Residential exit, anti-bot walls, JS rendering and extraction, all server-side, on us.
You get
Clean JSON
A structured object every time. No HTML, no scraping code, no maintenance.
The TikTok Top Search endpoint is one API call: send a search query with your HProxy key and get back a clean, structured JSON object. Pull TikTok's blended top results for a query, the mix of videos, users and sounds the app itself puts above the fold. HProxy runs the proxies, sessions, anti-bot handling and parsing server-side, so there is no headless browser to babysit and no parser to keep fixing when TikTok changes its markup. You only ever touch the JSON. Longer result sets come back page by page with a cursor, so you can walk the whole set without holding it in memory.
What the TikTok Top Search API returns
items[]
The ranked trend feed as the platform orders it.
rank / change
Current position and movement since the last window.
region
The market the ranking was computed for.
Example response
{
"region": "US",
"items": [
{ "rank": 1, "change": 4, "title": "the sound everyone is using", "id": "72901..." }
]
}Trimmed for brevity. Every call returns the full object with all fields listed here.
The TikTok top search endpoint
Full TikTok reference →/api/v1/scrape/tiktok/search-topParameters
querystringrequiredSearch term or keyword.
publish_timestringoptionalFilter by date, as YYYY-MM-DD. Allowed values: `yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`, `all-time`.
sort_bystringoptionalOrdering to apply to the results. Allowed values: `relevance`, `most-liked`, `date-posted`.
regionstringoptionalTwo-letter region/country code, e.g. US.
cursorintegeroptionalPagination token from the previous response.
Example request
curl "https://hproxy.com/api/v1/scrape/tiktok/search-top?query=coffee" \
-H "X-API-Key: hpx_your_key_here"POST with a JSON body works too. Failed calls, timeouts and rate-limited calls are never billed.
Scraping TikTok top search in three steps
Create a free account
Sign up and top up any amount. The balance pays for every HProxy product and never expires.
Grab your API key
One key from the dashboard authenticates every scraper, TikTok top search included.
Call the endpoint
Send the target to the TikTok Top Search endpoint and read the JSON. That is the whole integration.
No captchas, ever
Anti-bot walls, JS rendering and rate limits are handled server-side. You call an API, that is the whole job.
Residential-backed
Every request exits through HProxy's own residential network, so it looks like a real user on a real device.
Pay per call
No subscription, no seat licenses. Calls are billed from your balance and the balance never expires.
Fresh on every call
Responses are scraped live at request time, no stale cache dressed up as data.
Failures are free
Automatic retries first; if an extraction still fails, the call is not charged.
Scales with you
From one call to millions: same endpoint, same price curve, volume discounts as you grow.
What people build with it
Catch a trend on TikTok while it is still climbing.
Feed a trend dashboard that refreshes on every call.
Compare what is trending across regions.
TikTok Top Search pricing
$3.00
per 1,000 calls · 0.3¢ each
Pay per call, no subscription
Failed extractions are not charged
Proxies included in the price