Skip to main content
POST
douyin fetch_discuss_search
获取讨论搜索 计费 — 按成功调用计费,最终扣费按你的套餐倍率浮动。仅当上游响应体 code 为 200 时计费。

示例

请求规范

完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

公开参考价格:每次成功请求 $0.01 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.01
  • 计费依据: fixed_success
  • 公开参考倍率: 1.0
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

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

请求体

application/json
backtrace
string
默认值:""

Backtrace for pagination, obtained from the last response

content_type
string
默认值:0

Content type: 0=All, 1=Video, 2=Picture, 3=Article

Usage: Content type filter

  • 0: Unlimited
  • 1: Video
  • 2: Picture
  • 3: Article
cursor
integer
默认值:0

Offset cursor for pagination, obtained from the last response

Usage: Pagination cursor (0 for first page, use the last response cursor for subsequent pages)

filter_duration
string
默认值:0

Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes

keyword
string
默认值:猫咪

Keyword

publish_time
string
默认值:0

Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year

search_id
string
默认值:""

Search ID for pagination, obtained from the last response

sort_type
string
默认值:0

Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest

Usage: Sorting method

  • 0: Comprehensive
  • 1: Most likes
  • 2: Latest

响应

Successful Response

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

  • data: List of search result items
    • type: Result type (usually 1)
    • aweme_info: Video information
      • aweme_id: Video ID
      • desc: Description
      • author:
        • uid: User ID
        • nickname: User nickname
        • is_verified: Verified user or not
        • region: User region
        • avatar_thumb.url_list: Thumbnail avatar URLs
        • avatar_medium.url_list: Medium avatar URLs
        • avatar_larger.url_list: Large avatar URLs
      • video:
        • play_addr.url_list: Video playback URLs
        • cover.url_list: Video cover URLs
        • dynamic_cover.url_list: Dynamic cover URLs
        • origin_cover.url_list: Original cover URLs
        • width: Width in pixels
        • height: Height in pixels
        • ratio: Resolution ratio (e.g., 540p)
        • duration: Duration in milliseconds
        • download_addr.url_list: Download URLs with watermark
      • statistics:
        • comment_count: Number of comments
        • digg_count: Number of likes
        • share_count: Number of shares
        • play_count: Number of plays
        • collect_count: Number of collections
      • cha_list:
        • cha_name: Hashtag name
        • share_url: Hashtag share link
      • music:
        • id_str: Music ID
        • title: Music title
        • author: Music creator name
        • play_url.url_list: List of music playback URLs
      • status:
        • is_delete: Whether deleted
        • is_private: Whether private
        • allow_share: Allow sharing
        • allow_comment: Allow commenting
      • share_url: External video share link
cache_message
string | null
默认值: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
默认值:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

code
integer
默认值:200

HTTP 状态码

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
默认值:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
默认值:请求成功,本次请求将被计费。

Response message (ZH-CN)

params
any
默认值:{}

The parameters used in the request

request_id
string | null

Unique request identifier

router
string
默认值:""

The endpoint that generated this response

support
string
默认值: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
默认值:America/Los_Angeles

The timezone of the response time