JustSERPDocs
TikTok

TikTok Autocomplete

The suggestions TikTok's search box gives for what has been typed, in its order, answered as the document: `suggestions`.

GET
/v1/tiktok/autocomplete

The suggestions TikTok's search box gives for what has been typed, in its order, answered as the document: suggestions. A suggestion is a search phrase (type: query) or an account (type: profile, value is its username). Suggestions follow the language of the query itself. TikTok has no suggestions for some inputs: suggestions is then empty. zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

The partial or full search text.

Lengthlength <= 200
country?string

The market whose suggestions are asked for.

Default"US"
Value in"US""GB""CA""AU""NZ""IE""DE""FR""ES""IT""PT""NL""BE""AT""CH""SE""NO""DK""FI""PL""CZ""RO""HU""GR""TR""IL""AE""SA""EG""MA""BR""MX""AR""CO""CL""PE""JP""KR""TW""PH""ID""TH""VN""MY""SG""PK""BD""NG""ZA""KE""UA""KZ"
language?string

The language the TikTok app is set to.

Default"en"
Value in"en""sq""ar""az""bn""bg""my""ca""ceb""zh-cn""zh-tw""hr""cs""da""nl""et""fil""fi""fr""de""el""he""hi""hu""is""id""ga""it""ja""jv""kk""km""ko""lv""lt""ms""nb""pl""pt""ro""ru""sk""sl""es""sw""sv""th""tr""uk""ur""uz""vi"

Response Body

The suggestions, as the document. When the call could not be parsed, the usual envelope.

application/json
  1. response

The first keys of a document-form answer. Unlike DocumentHead there is no search_information unless the engine has one (there is none for the AI engines, Events, Events Details, Facebook, Tripadvisor Place, Trending Now and the Apple engines' places).

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
suggestions?array<>
Example Request
curl -X GET 'https://api.justserp.com/v1/tiktok/autocomplete?q=taylor'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "suggestions": [    {      "position": 0,      "type": "query",      "value": "string",      "language": "string",      "score": 0,      "username": "string",      "name": "string",      "link": "string",      "is_verified": true    }  ]}