Skip to content

Structured TikTok data: send queries. Single lookup, 1 credit per successful call.

GET · POST1 credit / successful callSingle lookup
GEThttps://api.scrapier.io/api/v2/tiktok-search-suggestions/Open in Playground

Call GET /api/v2/tiktok-search-suggestions/ with queries. The results are in data.suggestions. 3 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/tiktok-search-suggestions/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "queries=dogs" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
queriesstringyese.g. dogsPartial search term typed into TikTok's search box -> its whole autocomplete list (<= 20 rows, TikTok's rank order) under suggestions in ONE guest request. The source has no paging token, so next_cursor is always null.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
regionstringnousISO 3166-1 alpha-2 country to localise the list (default us): carrier / system region + that market's UI language; US -> TikTok's US datacenter host first. Echoed on the envelope; pins the proxy exit country.
locked in cursor
languagestringno—UI language override layered on top of region, e.g. pt-BR. Blank = the market's default.
locked in cursor
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"queries": "dogs",
"keyword": "dogs",
"region": "US",
"language": "en",
"page": 1,
"page_size": 20,
"suggestions": [
{
"keyword": "dogs",
"position": 3,
"region": "US",
"language": "en",
"text": "dogs yeast treatment",
"suggestion_language": "en",
"score": 0.00057434535,
"source": "app",
"search_url": "https://www.tiktok.com/search?q=dogs+yeast+treatment",
"hot_level": 0,
"ecom_intent": 2,
"recall_reasons": [
"tiktok_orion_sug_ecom_merged_outside_mall"
],
"scraped_at": "2026-09-21T08:26:46.010Z",
"...": "... every v1 row field (tokens, ranges, flags, penetrate_info, native, ...)"
},
"... 19 more rows in TikTok rank order ..."
],
"next_cursor": null
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.suggestions.

FieldTypeExampleDescription
queriesstringdogs—
keywordstringdogs—
regionstringUS—
languagestringen—
pageinteger1—
page_sizeinteger20—
suggestionsarray[2 items]The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
suggestions[].keywordstringdogs—
suggestions[].positioninteger3—
suggestions[].regionstringUS—
suggestions[].languagestringen—
suggestions[].textstringdogs yeast treatment—
suggestions[].suggestion_languagestringen—
suggestions[].scorenumber0.00057434535—
suggestions[].sourcestringapp—
suggestions[].search_urlstringhttps://www.tiktok.com/search?q=dogs+yeast+tr…—
suggestions[].hot_levelinteger0—
suggestions[].ecom_intentinteger2—
suggestions[].recall_reasonsarray[1 item]—
suggestions[].scraped_atstring2026-09-21T08:26:46.010Z—
suggestions[]....string... every v1 row field (tokens, ranges, flags…—

Returns everything in one call; next_cursor is always null.

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • Nothing special: send the inputs, read the result.
  • TikTok Ad Library Leads — Structured TikTok data: every input is optional. Single lookup, 3 credits per successful call.
  • TikTok Ad Library — Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.
  • TikTok Ads Top — Structured TikTok data: every input is optional. Cursor-paginated, 1 credit per successful call.
  • TikTok Collection Videos — Structured TikTok data: send urls. Cursor-paginated, 1 credit per successful call.