SandBaseSandBase
Start building
Use in agentDocsDouyin models

Douyin modelsapi generation api

douyin/search/image-search

Fetch image-based search results from Douyin App. Mainly returns posts containing image collections.

Input
Idle

Example output — click Run to generate your own

API README

Fetch image search

Purpose:

  • Fetch image-based search results from Douyin App.
  • Mainly returns posts containing image collections.

Notes:

  • Only image posts are returned. Suitable for gallery-style applications.
  • 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.

Parameters:

  • keyword: Search keyword, e.g., "cat"
  • cursor: Pagination cursor (0 for first request)
  • sort_type: Sorting method
    • 0: Comprehensive
    • 1: Most likes
    • 2: Latest
  • publish_time: Publish time filter
    • 0: Unlimited
    • 1: Last day
    • 7: Last week
    • 180: Last half year
  • filter_duration: Video duration filter
    • 0: Unlimited
  • content_type: Content type (Fixed to 2 for images)
  • search_id: Search ID for pagination

Request Body Example:

payload = {
    "keyword": "cat",
    "cursor": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "2",
    "search_id": ""
}

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

  • cursor: Cursor for next page
  • has_more: Whether there are more results (1=Yes, 0=No)
  • data[]: List of image posts
    • aweme_info:
      • aweme_id: Content ID
      • desc: Post description
      • create_time: Creation timestamp
      • author:
        • uid: Author ID
        • nickname: Nickname
        • is_verified: Verified status
        • avatar_thumb.url_list: Thumbnail avatar URLs
        • avatar_medium.url_list: Medium avatar URLs
        • avatar_larger.url_list: High-res avatar URLs
      • image_post_info:
        • images[]: List of images
          • url_list: Image URLs (webp/jpg)
          • width: Width (pixels)
          • height: Height (pixels)
      • statistics:
        • comment_count: Comment count
        • digg_count: Like count
        • share_count: Share count
        • play_count: Play count
        • collect_count: Collect count
      • status:
        • is_delete: Whether deleted
        • is_private: Whether private
      • share_url: Shareable external link
  • extra:
    • now: Current server timestamp
    • logid: Request log ID
    • search_request_id: Search session 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-search-v3Fetch image-text content search results from Douyin App. Returns posts with multiple images (aweme_type=68), suitable for gallery-style applications.