Skip to main content
GET
Reference example
Search Anchor 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: GET /apis/v1/tikhub/douyin/xingtu_v2/search_anchor
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/tikhub/douyin/xingtu_v2/search_anchor
  • author_list_id: query; optional
  • burst_text_rate_max: query; optional
  • burst_text_rate_min: query; optional
  • cpe_max: query; optional
  • cpe_min: query; optional
  • cpm_max: query; optional
  • cpm_min: query; optional
  • expected_play_max: query; optional
  • expected_play_min: query; optional
  • extra_filter: query; optional
  • fans_max: query; optional
  • fans_min: query; optional
  • first_industry_id: query; optional
  • gender: query; optional
  • interact_rate_max: query; optional
  • interact_rate_min: query; optional
  • keyword: query; required
  • marketing_target: query; optional
  • page: query; optional
  • persona_tags: query; optional
  • play_over_rate_max: query; optional
  • play_over_rate_min: query; optional
  • price_max: query; optional
  • price_min: query; optional
  • price_type: query; optional
  • sort_field: query; optional
  • sort_type: query; optional
  • tag: query; optional
  • task_category: query; optional
  • Runtime facts: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.001 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.001
  • 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.

Query Parameters

author_list_id
string | null

Featured creator list ID

burst_text_rate_max
number | null

Maximum viral-post rate, 0-1 decimal

Required range: 0 <= x <= 1
burst_text_rate_min
number | null

Minimum viral-post rate, 0-1 decimal

Required range: 0 <= x <= 1
cpe_max
number | null

Maximum expected CPE

cpe_min
number | null

Minimum expected CPE

cpm_max
number | null

Maximum expected CPM

cpm_min
number | null

Minimum expected CPM

expected_play_max
integer | null

Maximum expected plays

expected_play_min
integer | null

Minimum expected plays

extra_filter
string | null

Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings

fans_max
integer | null

Maximum followers

fans_min
integer | null

Minimum followers

first_industry_id
integer | null

Industry ID

gender
integer | null

Creator gender, 1=male, 2=female

interact_rate_max
number | null

Maximum interaction rate, 0-1 decimal

Required range: 0 <= x <= 1
interact_rate_min
number | null

Minimum interaction rate, 0-1 decimal (e.g. 0.02=2%)

Required range: 0 <= x <= 1
keyword
string
required

Search keyword: nickname, Douyin ID, Xingtu ID or live content word

marketing_target
integer
default:3

Marketing target

page
integer
default:1

Page number

persona_tags
string | null

Persona IDs (persona/education/certification/tone). Comma=match any; semicolon=group AND, e.g. 1129,110401;110213

play_over_rate_max
number | null

Maximum play-completion rate, 0-1 decimal

Required range: 0 <= x <= 1
play_over_rate_min
number | null

Minimum play-completion rate, 0-1 decimal

Required range: 0 <= x <= 1
price_max
integer | null

Maximum anchor price; price_type must also be provided when this field is supplied

Required range: x >= 0
price_min
integer | null

Minimum anchor price; price_type must also be provided when this field is supplied

Required range: x >= 0
price_type

Live-stream price type, fixed to 9; used only in combination with price_min/price_max

Available options:
9
sort_field
string
default:score

Sort field, default score (comprehensive)

sort_type
integer
default:2

Sort type: 1=asc, 2=desc

tag
string | null

Creator category IDs, comma-separated, e.g. 1,6

task_category
integer
default:6

Cooperation target

Response

Successful Response

Return

  • Anchor search result data (anchor info, live price, ACU/PCU, avg viewers, etc.)
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