Social Fetch
Get API key
TikTok hub

TikTok Search Suggestions API

Typeahead suggestions for a TikTok search box — suggested query text plus rank, language, and score when available.

GET /v1/tiktok/search/suggestions

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

`GET /v1/tiktok/search/suggestions` takes a required `query` string and an optional `region` (two-letter ISO 3166-1 country code) and returns autocomplete rows under `data.suggestions`. The response also echoes `data.query` and `data.totalSuggestions`. This route has no `lookupStatus`. An empty `data.suggestions` array with `data.totalSuggestions` of 0 is a valid success when there are no matches. Bill from `meta.creditsCharged`.

This route is typeahead only. Video keyword search is `GET /v1/tiktok/search`. Hashtag search is `GET /v1/tiktok/search/hashtags`. Account discovery is `GET /v1/tiktok/users/search`.

TikTok Search Suggestions API FAQ

How do I get TikTok search suggestions via API?

Call `GET /v1/tiktok/search/suggestions` with your Social Fetch API key (`x-api-key`) and a required `query` parameter. Optionally add `region` as a two-letter ISO country code. Read `data.suggestions`, `data.totalSuggestions`, and `data.query` in the JSON response. See the API docs for parameters and examples.

How much does TikTok search suggestions cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

What does each TikTok search suggestion row include?

Each row includes `text` (the suggested query), plus `position`, `language`, and `score` when available. Missing optional fields are returned as null rather than omitted.

Search suggestions vs video search vs hashtag search vs user search?

Use this route for typeahead query suggestions. Use `GET /v1/tiktok/search` for free-text video search. Use `GET /v1/tiktok/search/hashtags` for tag discovery. Use `GET /v1/tiktok/users/search` to find accounts. They are separate operations on the TikTok hub.

What does an empty suggestions list mean?

HTTP 200 with `data.suggestions` as an empty array and `data.totalSuggestions` of 0. That is a valid success when there are no autocomplete matches, not an error. Confirm billing with `meta.creditsCharged`.

Do I need TikTok OAuth to get search suggestions?

No. You authenticate to Social Fetch with an API key. The route returns public autocomplete suggestions; it does not act on behalf of a logged-in TikTok user.

Other TikTok endpoints