Get TikTok search suggestions

Get TikTok search suggestions by query.

GET/v1/tiktok/search/suggestions
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
querystringrequiredquery

Search query text for TikTok suggestions.

min 1 chars · max 512 chars

regionstringoptionalquery

Optional two-letter ISO 3166-1 country code for localized suggestions.

Response fields
13

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Autocomplete suggestions returned for the search query.

datasuggestions[]text
string

Suggested search text.

min 1 chars

datasuggestions[]position
integernullable

Zero-based rank of this suggestion in the returned list, when available.

≥ 0

datasuggestions[]language
stringnullable

Language code for this suggestion, when available.

datasuggestions[]score
numbernullable

Relative ranking score for this suggestion, when available.

datatotalSuggestions
integer

Number of suggestions returned in this response.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/tiktok/search/suggestions?query=dogs" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Search suggestions for the requested query.