---
title: "Retrieve TikTok search suggestions"
method: GET
path: "/tiktok/mobile/search/sug"
tags: ["TikTok"]
---

# Retrieve TikTok search suggestions

`GET /tiktok/mobile/search/sug`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/mobile/search/sug`
- Auth: API key in header `x-api-key`

Returns the mobile app's search typeahead for a seed keyword: `sug_list` of suggestions, each with `content`, `sug_type`, `word_record` (`group_id`, `words_position`, `words_content`, `words_source`) and positional fields, unmodified. Useful for query expansion and for seeing the phrases the app itself associates with a seed term. `keyword` is required; without it the upstream answers a well-formed but empty envelope.

## Query parameters

- `keyword` string, required
- `count` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokmobileSearchSuggestionResponseDoc
  - `code` integer
  - `data` TiktokmobileSearchSuggestionResponse
    - `extra` unknown
    - `has_more` boolean
    - `log_pb` unknown
    - `rid` string
    - `status_code` integer
    - `status_msg` string
    - `sug_list` TiktokmobileSearchSuggestion[]
      - `content` string
      - `extra_info` unknown
      - `highlight_pos` unknown
      - `pos` unknown
      - `rich_sug_sec_pos` unknown
      - `sug_type` string
      - `word_record` unknown
  - `msg` string

## Other responses

- `400`: Invalid input
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-10-19** `0497899e2016`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crawlora/apis/crawlora-api/changes/tiktok/mobile/search/sug/get.md)

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)