Douyin Image Search

Name: Douyin Image Search
Price: 0.015 USD
Availability: InStock
Author: Douyin

https://api.sandbase.ai/v1/api/douyin/search/image-search

Returns image-based search results from Douyin matching a search keyword. Supports sorting, content filtering, post date filters, and pagination parameters.

Try this API Get API key

Price: $0.01USD / callFirst 100 calls per day free (shared per organization)
Method: POST
Response: JSON
Parameters: 0 required · 8 optional

Production route

Try the model

Playground

Open playground

Input

Backtrace(string)

Backtrace for pagination, obtained from the last response

Content Type(string)

Content type (Fixed to 2 for images)

Cursor(integer)

Pagination cursor (0 for first request)

Filter Duration(string)

Video duration filter

Keyword(string)

Search keyword, e.g., "cat"

Publish Time(string)

Publish time filter

Search Id(string)

Search ID for pagination

Sort Type(string)

Sorting method

OutputExample

Responseoutputs · 1200.4 KB · 26,433 lines

[
  {
    "data": {
      "business_config": {
        "ad_info": null,
        "card_count": 20,
        "extra": {
          "is_filter_search": 0,
          "req_start_ts": 1787219240791
        },
        "extra_fresh_struct": null,
        "feedback": null,
        "feelgood_msg": {},
        "filter_bar": null,
        "has_more": 1,
        "is_filter_search": 0,
        "keyword": "猫咪",
        "next_page": {
          "cursor": 20,
          "keyword": "猫咪",
          "poi_search_info": "",
          "search_id": "202608201747200B846B2021BDE7CD8457",
          "search_request_id": "202608201747200B846B2021BDE7CD8457"
        },
        "poi_search_info": "",
        "pre_loadmore_config": null,
        "search_nil_info": null
      },
      "business_data": [
        {
          "card_id": "douyin.doctype_aweme_image",
          "data": {
            "aweme_info": {
              "activity_video_type": 0,
              "ai_follow_images": null,
              "ai_search_struct": {
                "show_ai_entrance": true
              },
              "anchors": null,
              "authentication_token": "MS4wLjAAAAAAJtYoCG6ybvaKpznD4H6EwV9cIPORWuU7mImpqSa54S80k2oyxyPkj2M0UyiMCKWbJqCKAZI65uhWpLtIL3MxW-w9dM3BdV7tU0HOQ0RIqVTY23Ei7E9H5oKjxXib1fahD6ZrNQSnVUahJnwSI9_8By04skTkNzR3kiI9ANitbU6zqbaT8EUzJzWvJgrAdWL3pOhkgMVBpqUhg_-6YhbwDXvXhOZvqxQSiUnwd0O57mHDzP0y5e95-OJBl5CRJnmo",
              "author": {
                "accept_private_policy": false,
                "account_cert_info": "{}",
                "account_region": "",
                "ad_cover_url": null,
                "allow_story_normal_like": false,
                "apple_account": 0,
                "authority_status": 0,
                "avatar_168x168": {
                  "height": 720,
                  "uri": "168x168/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d",
                  "url_list": [
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d~c5_168x168.webp?from=327834062",
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d~c5_168x168.jpeg?from=327834062"
                  ],
                  "width": 720
                },
                "avatar_300x300": {
                  "height": 720,
                  "uri": "300x300/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d",
                  "url_list": [
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d~c5_300x300.webp?from=327834062",
                    "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d~c5_300x300.jpeg?from=327834062"
                  ],
                  "width": 720
                },
                "avatar_larger": {
                  "height": 720,
                  "uri": "1080x1080/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d",
                  "url_list": [
                    "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d.webp?from=327834062",
                    "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d.jpeg?from=327834062"
                  ],
                  "width": 720
                },
                "avatar_medium": {
                  "height": 720,
                  "uri": "720x720/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d",
                  "url_list": [
                    "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d.webp?from=327834062",
                    "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d.jpeg?from=327834062"
                  ],
                  "width": 720
                },
                "avatar_schema_list": null,
                "avatar_thumb": {
                  "height": 720,
                  "uri": "100x100/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d",
                  "url_list": [
                    "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d.webp?from=327834062",
                    "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d.jpeg?from=327834062"
                  ],
                  "width": 720
                },
                "avatar_uri": "aweme-avatar/tos-cn-avt-0015_63e9f09ff719c0984720887008222c6d",
                "aweme_control": {
                  "can_comment": true,
                  "can_forward": true,
                  "can_share": true,
                  "can_show_comment": true
                },
                "aweme_count": 0,
                "aweme_hotsoon_auth": 1,
                "aweme_hotsoon_auth_relation": 1,
                "awemehts_greet_info": "",
                "ban_user_functions": [],
                "batch_unfollow_contain_tabs": null,
                "batch_unfollow_relation_desc": null,
                "bind_phone": "",
                "birthday": "",
                "can_set_geofencing": null,
                "card_entries": null,
                "card_entries_not_display": null,
                "card_sort_priority": null,
                "cf_list": null,
                "cha_list": null,
                "close_friend_type": 0,
                "comment_filter_status": 0,
                "comment_setting": 0,
                "commerce_user_level": 0,
                "constellation": 7,
                "contacts_status": 2,
                "contrail_list": null,
                "cover_url": [
                  {
                    "height": 720,
                    "uri": "c8510002be9a3a61aad2",
                    "url_list": [
                      "https://p3-sign.douyinpic.com/obj/c8510002be9a3a61aad2?lk3s=138a59ce&x-expires=1788426000&x-signature=JvJ3QRyF5z8K0MAjsm3BIcA4sFg%3D&from=327834062"
                    ],
                    "width": 720
                  }
                ],
                "create_time": 0,
                "creator_tag_list": null,
                "custom_verify": "",
                "cv_level": "",
                "data_label_list": null,
                "disable_image_comment_saved": 0,
                "display_info": null,
                "download_prompt_ts": 0,
                "download_setting": -1,
                "duet_setting": 0,
                "enable_nearby_visible": true,
                "endorsement_info_list": null,
                "enterprise_verify_reason": "",
                "familiar_confidence": 0,
                "familiar_visitor_user": null,
                "favoriting_count": 0,
                "fb_expire_time": 0,
                "follow_status": 0,
                "follower_count": 119851,
                "follower_list_secondary_information_struct": null,
                "follower_request_status": 0,
                "follower_status": 0,
                "followers_detail": null,
                "following_count": 0,
                "gender": 2,
                "geofencing": [],
                "google_account": "",
                "has_email": false,
                "has_facebook_token": false,
                "has_insights": false,
                "has_orders": false,
                "has_twitter_token": false,
                "has_unread_story": false,
                "has_youtube_token": false,
                "hide_location": false,
                "hide_search": true,
                "homepage_bottom_toast": null,
                "house_talent_info": 0,
                "identity_labels": null,
                "im_role_ids": null,
                "ins_id": "",
                "interest_tags": null,
                "is_ad_fake": false,
                "is_ban": false,
                "is_binded_weibo": false,
                "is_block": false,
                "is_blocked_v2": false,
                "is_blocking_v2": false,
                "is_cf": 0,
                "is_discipline_member": false,
                "is_gov_media_vip": false,
                "is_mix_user": false,
                "is_not_show": false,
                "is_phone_binded": false,
                "is_star": false,
                "is_verified": true,
                "item_list": null,
                "ky_only_predict": 0,
                "language": "zh-Hans",
                "link_item_list": null,
                "live_agreement": 0,
                "live_agreement_time": 0,
                "live_commerce": false,
                "live_high_value": 0,
                "live_status": 0,
                "live_verify": 0,
                "location": "",
                "mate_add_permission": 1,
                "mate_count": 0,
                "mate_relation": {
                  "mate_apply_forward": 0,
                  "mate_apply_reverse": 0,
                  "mate_status": 0
                },
                "max_follower_count": 0,
                "need_points": null,
                "need_recommend": 0,
                "neiguang_shield": 0,
                "new_story_cover": null,
                "nickname": "小芝麻小黄豆",
                "not_seen_item_id_list": null,
                "not_seen_item_id_list_v2": null,
                "offline_info_list": null,
                "personal_tag_list": null,
                "platform_sync_info": null,
                "prevent_download": false,
                "private_relation_list": null,
                "profile_component_disabled": null,
                "profile_mob_params": null,
                "profile_signature_components": null,
                "react_setting": 0,
                "reflow_page_gid": 0,
                "reflow_page_uid": 0,
                "region": "CN",
                "relative_users": null,
                "risk_notice_text": "",
                "room_id": 0,
                "room_id_str": "0",
                "school_category": 0,
                "school_id": "",
                "school_name": "",
                "school_poi_id": "",
                "school_type": 0,
                "search_impr": {
                  "entity_id": "7474251619262284859"
                },
                "sec_uid": "MS4wLjABAAAACggktWUeVdTMXNJdU_8pZ9NyTGfzt4b-7nfQdG7sLVW7Qymc0045Hb42J1tA3tRS",
                "secret": 0,
                "share_info": {
                  "share_desc": "",
                  "share_desc_info": "",
                  "share_qrcode_url": {
                    "height": 720,
                    "uri": "",
                    "url_list": [],
                    "width": 720
                  },
                  "share_title": "",
                  "share_title_myself": "",
                  "share_title_other": "",
                  "share_url": "",
                  "share_weibo_desc": ""
                },
                "share_qrcode_uri": "",
                "shield_comment_notice": 0,
                "shield_digg_notice": 0,
                "shield_follow_notice": 0,
                "short_id": "91374431418",
                "show_image_bubble": false,
                "show_nearby_active": false,
                "signature": "小芝麻，三花妹妹     小黄豆，橘白哥哥\n📝多猫家庭，翻到小时候可爱库存就会随手发出来哈哈哈\n💌xhdxzm ⚠️抄袭搬运必究！！！",
                "signature_display_lines": 5,
                "signature_extra": null,
                "social_real_relation_type": 0,
                "special_follow_status": 0,
                "special_lock": 1,
                "special_people_labels": null,
                "status": 1,
                "stitch_setting": 0,
                "story25_comment": 1,
                "story_count": 0,
                "story_interactive": 4,
                "story_open": false,
                "story_ttl": 7,
                "sync_to_toutiao": 0,
                "text_extra": [],
                "total_favorited": 0,
                "tw_expire_time": 0,
                "twitter_id": "",
                "twitter_name": "",
                "type_label": null,
                "uid": "7474251619262284859",
                "unique_id": "91374431418",
                "unique_id_modify_time": 1787219241,
                "user_age": -1,
                "user_canceled": false,
                "user_mode": 0,
                "user_not_see": 0,
                "user_not_show": 1,
                "user_period": 0,
                "user_permissions": null,
                "user_rate": 1,
                "user_tags": null,
                "verification_permission_ids": null,
                "verification_type": 1,
                "verify_info": "",
                "video_icon": {

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price: $0.01 / run
Daily free calls: First 100 calls per day free (shared per organization)

Request & response

Method: POST
Request body: application/json
Response: application/json
Execution: sync

Parameters

backtrace: string · optional
content_type: string · optional
cursor: integer · optional
filter_duration: string · optional
keyword: string · optional
publish_time: string · optional
search_id: string · optional
sort_type: string · optional

Access

Provider: Douyin
API: Platform API
Base URL: https://api.sandbase.ai
Endpoint: /v1/api/douyin/search/image-search
Authentication: Bearer API key

API README

Douyin Image Search API

Look up Douyin image search results by specifying a keyword. Paginate through results using cursor, search_id, and backtrace.

Use cases

Search for image posts matching specific keywords.
Track relevant graphic content and topics on Douyin.
Filter image search results by post date and sorting criteria.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/search/image-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Parameters

Name	Type	Required	Description
`cursor`	integer	No	Pagination cursor (0 for first request)
`keyword`	string	No	Search keyword, e.g., "cat"
`backtrace`	string	No	Backtrace for pagination, obtained from the last response
`search_id`	string	No	Search ID for pagination
`sort_type`	string	No	Sorting method
`content_type`	string	No	Content type (Fixed to 2 for images)
`publish_time`	string	No	Publish time filter
`filter_duration`	string	No	Video duration filter

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "business_data": [
    {
      "card_id": "douyin.doctype_aweme_image",
      "data_id": "0",
      "type": 11,
      "data": {
        "card_id": "douyin.doctype_aweme_image",
        "card_type": 1,
        "doc_type": 303,
        "provider_doc_id": 7693421414359489253,
        "provider_doc_id_str": "7693421414359489253",
        "type": 1
      }
    }
  ]
}

Notes

cursor starts at 0 for the initial request.
content_type is fixed to 2 for images.
backtrace and search_id are passed from previous responses for pagination.

Related APIs

Douyin Challenge Search: Returns Douyin challenge and hashtag search results matching a query.
Douyin Hashtag Challenge Search (V2): Returns Douyin hashtag and challenge search results matching a query keyword.
Douyin Hashtag Suggestions: Returns a list of suggested Douyin hashtags and challenges matching a query keyword, including challenge IDs and view counts.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API

Platform API endpoint

https://api.sandbase.ai/v1/api/douyin/search/image-search

Authorization header

Authorization: Bearer $SANDBASE_API_KEY

# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/douyin/search/image-search" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "cursor": 0,
  "keyword": "猫咪",
  "backtrace": "",
  "search_id": "",
  "sort_type": "0",
  "content_type": "0",
  "publish_time": "0",
  "filter_duration": "0"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs

API	Price	Response	Released
Douyin Image SearchThis API `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Challenge Search `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Hashtag Challenge Search (V2) `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Hashtag Suggestions `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Discussion Search `Douyin`	$0.01 per call	JSON	Jul 31, 2026
Douyin Experience Content Search `Douyin`	$0.01 per call	JSON	Jul 31, 2026

Questions

FAQ

How do I use the Douyin Image Search API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/search/image-search with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Douyin Image Search API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Douyin Image Search API accept?

No parameters are required. Optional: backtrace (string), content_type (string), cursor (integer), filter_duration (string), keyword (string) and publish_time (string) and 2 more. The Parameters table and the Playground on this page list every field.

What does the Douyin Image Search API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Douyin developer account or API key?

No. Douyin Image Search runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.