获取图文搜索 V3/Fetch image-text search V3

[中文]

用途:

• 获取抖音 App 中图文内容搜索的结果。
• 返回带有多张图片的帖子（aweme_type=68），适用于图文展示类应用场景。

备注:

• 该接口与 fetch_image_search 使用不同的数据源，返回结果可能有所差异。
• 推荐用于需要高质量图文内容的场景。
• 初次请求时 cursor 传 0，search_id 传空字符串。
• 翻页请求时，使用上一次响应返回的 cursor 和 search_id。
• 每页返回约 12 条数据。

参数:

• keyword: 搜索关键词，如 "美食"
• cursor: 翻页游标（首次请求传 0）
• search_id: 搜索ID（翻页时使用上次响应中的值）

请求体示例：

payload = {
    "keyword": "美食",
    "cursor": 0,
    "search_id": ""
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

• status_code: 状态码（0=成功）
• business_data[]: 图文内容列表
  • data:
    • aweme_list[]: 内容列表
      • aweme_id: 内容ID
      • aweme_type: 内容类型（68=图文）
      • desc: 帖子描述文字
      • create_time: 创建时间戳
      • author:
        • uid: 作者ID
        • nickname: 昵称
        • avatar_thumb.url_list: 缩略头像URL列表
      • image_post_info:
        • images[]: 图片列表
          • url_list: 图片地址数组
          • width: 图片宽度（像素）
          • height: 图片高度（像素）
      • statistics:
        • comment_count: 评论数
        • digg_count: 点赞数
        • share_count: 分享数
        • collect_count: 收藏数
      • share_url: 外部分享链接
• extra:
  • now: 当前服务器时间戳
  • logid: 请求日志ID

---

[English]

Purpose:

• Fetch image-text content search results from Douyin App.
• Returns posts with multiple images (aweme_type=68), suitable for gallery-style applications.

Notes:

• This endpoint uses a different data source than fetch_image_search, results may vary.
• Recommended for scenarios requiring high-quality image-text content.
• For the first request, set cursor to 0 and search_id to an empty string.
• For pagination, use the cursor and search_id from the last response.
• Returns approximately 12 items per page.

Parameters:

• keyword: Search keyword, e.g., "food"
• cursor: Pagination cursor (0 for first request)
• search_id: Search ID for pagination (use value from previous response)

Request Body Example:

payload = {
    "keyword": "food",
    "cursor": 0,
    "search_id": ""
}

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

• status_code: Status code (0=success)
• business_data[]: Image-text content list
  • data:
    • aweme_list[]: Content list
      • aweme_id: Content ID
      • aweme_type: Content type (68=image-text)
      • desc: Post description
      • create_time: Creation timestamp
      • author:
        • uid: Author ID
        • nickname: Nickname
        • avatar_thumb.url_list: Thumbnail avatar URLs
      • image_post_info:
        • images[]: Image list
          • url_list: Image URLs array
          • width: Width (pixels)
          • height: Height (pixels)
      • statistics:
        • comment_count: Comment count
        • digg_count: Like count
        • share_count: Share count
        • collect_count: Collect count
      • share_url: Shareable external link
• extra:
  • now: Current server timestamp
  • logid: Request log ID

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.