Douyin modelsapi generation api

douyin/search/image-search-v3

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

Input
Idle

Example output — click Run to generate your own

API README

Fetch image-text search V3

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.

Related Models

douyin/search/challenge-search-v1Fetch hashtag/challenge search results from Douyin App. Returns related hashtag topics including name, view count, participants, and cover images.douyin/search/challenge-search-v2Fetch hashtag/challenge search results from Douyin App using V2 API. Supports searching by keyword and returns detailed challenge information, including name, cover image, view count, and participant count.douyin/search/challenge-suggestFetch hashtag/challenge suggestions from Douyin App based on the input keyword. Returns a list of related hashtags including name and view count.douyin/search/discuss-searchFetch discussion/Q&A search results from Douyin App. Supports filtering by keyword, sort type, publish time, content type, etc.douyin/search/experience-searchFetch experience (knowledge/tutorial) content search results from Douyin App. Retrieves video results related to knowledge sharing, tutorials, or tips based on the input keyword.douyin/search/general-search-v1Fetch search results from Douyin App's general search tab (not standalone video search). Supports filtering by keyword, sort type, publish time, video duration, and content type. Supports pagination through `cursor`, `search_id`, and `backtrace`.douyin/search/general-search-v2Fetch search results from Douyin App's general search tab (not standalone video search). This API may be less stable than V1, serving as a backup. Supports filtering by keyword, sort type, publish time, video duration, and content type. Supports pagination through `cursor`, `search_id`, and `backtrace`.douyin/search/image-searchFetch image-based search results from Douyin App. Mainly returns posts containing image collections.