douyin/search/vision-search

Fetch vision search (image-based search)

Purpose:

• Douyin APP vision search (image-based search / reverse image search).
• Search for similar videos/images using an image.
• The image_uri can be obtained from other Douyin API responses (such as video details, search results, user profile, etc.), and used directly for vision search.

Notes:

• Set cursor to 0 and search_id to empty string for the first request.
• For pagination, obtain cursor and search_id values from the previous response.
• image_uri is a required parameter. It can be obtained from Douyin API responses that contain image information, such as video details API, general search API, user profile API, etc. These responses typically include image URIs that can be used directly for vision search.
• detection represents the area to be recognized in the image, format "x1,y1,x2,y2", default "0.1,0.1,0.9,0.9" means the whole image.

Parameters:

• image_uri: Image URI obtained from other Douyin API responses (e.g., video details, search results, user profile) (required)
• cursor: Pagination cursor (0 for the first page)
• search_id: Search ID (empty for first request, obtained from previous response for pagination)
• search_source: Search source
  • graphic_detail: Image detail page search (default)
  • visual_normal_search: Search with keyword append (requires user_query)
• detection: Detection area coordinates, format "x1,y1,x2,y2"
• detection_index: Detection index, default 0
• user_query: Search keyword, only used when search_source="visual_normal_search"
• aweme_id: Original video ID, only used when search_source="visual_normal_search"

Request Body Example: Basic image search:

payload = {
    "image_uri": "20251221204239F0C21D7645F172B6085C",
    "cursor": 0,
    "search_id": "",
    "search_source": "graphic_detail",
    "detection": "0.1,0.1,0.9,0.9",
    "detection_index": 0
}

Search with keyword append:

payload = {
    "image_uri": "20251221204239F0C21D7645F172B6085C",
    "cursor": 0,
    "search_id": "2025122120452038252994F25A4BAEB043",
    "search_source": "visual_normal_search",
    "detection": "0.1,0.1,0.9,0.9",
    "detection_index": 0,
    "user_query": "game",
    "aweme_id": "7523532488087817529"
}

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

• status_code: Response status code (0 means success)
• cursor: Cursor for next page
• has_more: Whether more data is available (1=Yes, 0=No)
• search_id: Search ID for pagination
• data[]: List of search results
  • type: Result type
  • aweme_info: Video/image post details
    • aweme_id: Video ID
    • desc: Video description
    • author: Author information
    • video: Video playback information
    • statistics: Interaction statistics

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