Social Fetch
Start for freeStart free
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