Skip to main content
POST
douyin fetch_search_suggest
Fetch search keyword suggestions Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body code is 200.

Example

Request contract

  • Method and path: POST /apis/v1/tikhub/douyin/search/fetch_search_suggest
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_search_suggest
  • Runtime facts: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.01
  • Cost contract: fixed_success
  • Published reference multiplier: 1.0
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keyword
string
default:人工智能

The keyword to be suggested

Response

Successful Response

Response (common fields, actual response may contain more fields)

  • status_code: Status code (0 means success)
  • status_msg: Response message (usually empty)
  • rid: Request ID
  • sug_list[]: List of suggested search keywords
    • content: Suggested keyword (e.g., "AI software free download")
    • sug_type: Suggestion type (usually empty, reserved field)
    • pos[]: Position marking
      • begin: Begin character position
      • end: End character position
    • word_record:
      • group_id: Suggestion group ID
      • words_position: Position in the current suggestion list
      • words_content: The word content (same as content)
      • words_source: Word source (typically "sug")
    • extra_info:
      • client_server_extra: Extra client-server config (JSON string)
      • poi_id: Related POI ID (usually empty)
      • search_params: Search parameters (with recommendation scores)
  • words_query_record:
    • info: Additional info (usually empty)
    • words_source: Source of suggestions
    • query_id: Suggestion query ID
  • extra:
    • now: Current server timestamp (milliseconds)
    • logid: Log ID
    • fatal_item_ids: List of fatal error items (usually empty)
    • search_request_id: Search request ID (usually empty)
  • log_pb:
    • impr_id: Impression log ID
  • time_cost:
    • stream_inner: Internal stream processing time (milliseconds)
    • server_engine_cost: Server search engine processing time (milliseconds)
  • cache_conf:
    • enable: Whether cache was hit (boolean)
cache_message
string | null
default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh
string | null
default:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

code
integer
default:200

HTTP status code

data
any

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.

docs
string | null

Link to the API Swagger documentation for this endpoint

message
string
default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
default:请求成功,本次请求将被计费。

Response message (ZH-CN)

params
any
default:{}

The parameters used in the request

request_id
string | null

Unique request identifier

router
string
default:""

The endpoint that generated this response

support
string
default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time
string

The time the response was generated

time_stamp
integer

The timestamp the response was generated

time_zone
string
default:America/Los_Angeles

The timezone of the response time