TikTok · Search and trends

TikTok Keyword Search Scraper API

The TikTok Keyword Search endpoint is one API call: send a search query with your HProxy key and get back a clean, structured JSON object. Run any TikTok keyword search and get the ranked video results back as JSON, filterable by post date, sort order and region. 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.
  • 0.15¢ per call
  • $1.49 per 1,000
  • Takes a search query
  • Errors and timeouts are not charged

The call

One GET, and the keyword search comes back as JSON.

Your key goes in one header. 1 required parameter, and the answer is the object below it.

The full reference
curl "https://hproxy.com/api/v1/scrape/tiktok/search?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"
Response200 OK · JSON
{
  "query": "your query",
  "results": [
    { "type": "video", "id": "72901...", "title": "...", "stats": { "views": 12043 } }
  ],
  "cursor": "eyJwYWdlIjoyfQ"
}

What comes back

The TikTok keyword search object.

results[]
Ranked results in the platform's own order.
type
Result type (user, video, post, product) per item.
query
The query the ranking was computed for.
cursor
Pagination token to pull the next page of results.

What it takes

Parameters.

querystringRequiredcoffee

Search term or keyword.

date_postedstringyesterday

Filter by date, as YYYY-MM-DD. Allowed values: `yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`, `all-time`.

sort_bystringrelevance

Ordering to apply to the results. Allowed values: `relevance`, `most-liked`, `date-posted`.

regionstringUS

Two-letter region/country code, e.g. US.

cursorinteger0

Pagination token from the previous response.

trimbooleantrue

Return a slimmed-down payload (drops verbose fields).

How it works

Scraping TikTok keyword search, in three steps.

You write one line. Proxies, anti-bot walls, rendering and parsing happen on our side.

  1. 1

    Create a free account

    Sign up and top up any amount. The balance pays for every HProxy product.
  2. 2

    Grab your API key

    One key from the dashboard authenticates every scraper.
  3. 3

    Call the endpoint

    Send the GET you need and read the JSON. That is the entire integration.

What people build with it

Where the TikTok keyword search endpoint earns its keep.

  • Monitor TikTok for brand mentions, keywords or new competitors.
  • Build a trend-tracking pipeline off live search results.
  • Discover creators or products around any query.

TikTok keyword search questions

Answered before you ask.

The reference

Send one authenticated HTTPS request to the TikTok Keyword Search endpoint with a search query and your HProxy API key. Run any TikTok keyword search and get the ranked video results back as JSON, filterable by post date, sort order and region. No proxies, no headless browser and no parsing on your side. The response is ready-to-use JSON.

This endpoint is 0.15¢ per successful call, which is $1.49 per 1,000. It bills from your HProxy balance with no subscription and no monthly minimum. Errors are retried and never charged; a lookup whose target does not exist counts as a call.

No. Every call runs on HProxy's own residential network behind the scenes, so requests look like real users. The proxy layer is already included in the per-call price.

A structured JSON object with the full keyword search data TikTok exposes publicly. See the fields listed above. The schema is consistent across calls, so you integrate once and rely on it.

Yes. The response carries a cursor; pass it back on the next call to continue from where you stopped. Each page is one billable call, so you only pay for the depth you actually pull.

The API only accesses publicly available TikTok data, the same pages anyone can open in a browser. You are responsible for using the data in line with applicable laws and TikTok's terms for your use case.

More on the TikTok Keyword Search API

What the TikTok Keyword Search endpoint returns

Run any TikTok keyword search and get the ranked video results back as JSON, filterable by post date, sort order and region. The JSON object carries results[], type, query and cursor. Nothing is summarised away on our side, so what you read in the response is what the TikTok keyword search page itself holds.

What you send to the TikTok Keyword Search API

The call takes a search query. Required: query. Optional: date_posted, sort_by, region, cursor and trim. Your key travels in the X-API-Key header, the response is JSON, and the call is billed at 0.15¢, $1.49 per 1,000.

Search and trends on other platforms

The same search and trends data is available on 6 other platforms: YouTube Search, Instagram Reels Search, Reddit Search, Threads Search, Google Search Results and Pinterest Search. They share this endpoint's JSON shape, its per-call billing and your one API key, so moving from TikTok to another network is a change of URL rather than a second integration.

Is scraping TikTok keyword search allowed?

The endpoint reads publicly available TikTok data, the same pages anyone can open in a browser without logging in. It does not touch private accounts or anything behind a password. How you then use the data is yours to keep lawful, under the rules that apply to you and to TikTok.

Ready when you are.

Your dashboard is ten seconds away. No sales call, no subscription, no minimum.