--- title: "获取图文搜索 V3/Fetch image-text search V3" method: POST path: "/api/v1/douyin/search/fetch_image_search_v3" tags: ["Douyin-Search-API"] --- # 获取图文搜索 V3/Fetch image-text search V3 `POST /api/v1/douyin/search/fetch_image_search_v3` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/douyin/search/fetch_image_search_v3` - Auth: HTTP bearer # [中文] ### 用途: - 获取抖音 App 中图文内容搜索的结果。 - 返回带有多张图片的帖子（aweme_type=68），适用于图文展示类应用场景。 ### 备注: - 该接口与 `fetch_image_search` 使用不同的数据源，返回结果可能有所差异。 - 推荐用于需要高质量图文内容的场景。 - 初次请求时 `cursor` 传 0，`search_id` 传空字符串。 - 翻页请求时，使用上一次响应返回的 `cursor` 和 `search_id`。 - 每页返回约 12 条数据。 ### 参数: - keyword: 搜索关键词，如 "美食" - cursor: 翻页游标（首次请求传 0） - search_id: 搜索ID（翻页时使用上次响应中的值） ### 请求体示例： ```json 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: ```json 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 ## Request body - ImageSearchV3Request - `keyword` string, required: 搜索关键词/Search keyword - `cursor` integer: 翻页游标/Pagination cursor - `search_id` string: 搜索ID/Search ID for pagination ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 2 info - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `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.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - **2026-04-14** `ee5b7c9c88f5`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/search/fetch_image_search_v3/post.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)