Logo SearchApi

TikTok Autocomplete API Documentation

GET   /api/v1/search?engine=tiktok_autocomplete
OpenAPI Initiative Download OpenAPI Spec

The TikTok Autocomplete API returns the suggestions TikTok's search box shows while a keyword is being typed, in the order TikTok ranks them. Most are search phrases and some are TikTok accounts. Either value can be passed as the q of the TikTok Search API to run that search.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The partial or full keyword to autocomplete (e.g. messi). Returns the suggestions TikTok's search box shows for that text, in the order TikTok ranks them. Up to 200 characters. Suggestions follow the language of the query itself, so a Japanese query returns Japanese suggestions. Pass any suggestion's value as the q of the TikTok Search API to run that search.

Localization

  • Name
    country
    Required
    Optional
    Description

    The country whose TikTok market the suggestions come from, as a two-letter code (e.g. BR returns the suggestions TikTok shows users in Brazil). Check the full list of supported TikTok Autocomplete countries. Default: US.

  • Name
    language
    Required
    Optional
    Description

    The language the TikTok app is set to for the user the suggestions are ranked for, as a language code (e.g. pt, ja, zh-tw). A regional code such as pt-BR is accepted and applied as pt. It changes which of the country's suggestions rank highest, not the country, and each suggestion's own language still follows the query. Set it together with country to get what local users see (e.g. country=BR and language=pt). Check the full list of supported TikTok Autocomplete languages. Default: en.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to tiktok_autocomplete.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Suggestions

Suggestions

Each suggestion carries its position in TikTok's ranking, its type (query or profile) and the suggested text as value. A profile suggestion also carries the account's username, name, link and is_verified.

GET
https://www.searchapi.io/api/v1/search?engine=tiktok_autocomplete&q=messi
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_autocomplete",
  "q": "messi"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_RvzEGkNolVqF86m2pj4Q9WJb",
    "status": "Success",
    "created_at": "2026-10-05T12:52:46Z",
    "request_time_taken": 1.4,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.4,
    "request_url": "https://www.tiktok.com/search?q=messi",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_RvzEGkNolVqF86m2pj4Q9WJb.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_RvzEGkNolVqF86m2pj4Q9WJb"
  },
  "search_parameters": {
    "engine": "tiktok_autocomplete",
    "q": "messi"
  },
  "suggestions": [
    {
      "position": 1,
      "type": "query",
      "value": "messi columbus ohio hotel",
      "language": "en",
      "score": 0.00089991017
    },
    {
      "position": 2,
      "type": "query",
      "value": "messi world cup 2026 hotel",
      "language": "en",
      "score": 0.00094599935
    },
    {
      "position": 3,
      "type": "query",
      "value": "messi",
      "language": "it",
      "score": 0.035947412
    },
    {
      "position": 4,
      "type": "profile",
      "value": "Lionel messi",
      "score": 0.040937576,
      "username": "lionelmessio38",
      "name": "Lionel messi",
      "link": "https://www.tiktok.com/@lionelmessio38"
    },
    "..."
  ]
}