Douyin Search Fetch Multi Search

20.65 credits/call
ae_douyin_search_fetch_multi_search

## Purpose Search Douyin for mixed results, including videos, users, music, and hashtags, using a keyword and optional filters. ## Inputs Provide the required `request_body` object. Fields inside it are optional: - `keyword` (string): search term; default `"猫咪"` (cats). - `cursor` (integer): pagination cursor; default `0` for the first page. - `search_id` and `backtrace` (strings): pagination state from the preceding response; both default to `""`. - `sort_type` (string): `"0"` comprehensive, `"1"` most likes, `"2"` latest. - `publish_time` (string): `"0"` unrestricted, `"1"` last day, `"7"` last week, `"180"` last half year. - `filter_duration` (string): `"0"` unrestricted, `"0-1"` within one minute, `"1-5"` one to five minutes, `"5-10000"` over five minutes. - `content_type` (string): `"0"` all, `"1"` video, `"2"` picture, `"3"` article. All sorting and filter fields default to `"0"`. Keep these values as strings, unlike the integer `cursor`. For the first request, use `cursor: 0`, `search_id: ""`, and the default empty `backtrace`. For later pages, reuse the previous response's `cursor`, `search_id`, and `backtrace` when provided. Example tool input: ```json {"request_body":{"keyword":"人工智能","cursor":0,"search_id":"","backtrace":"","sort_type":"0","publish_time":"0","filter_duration":"0","content_type":"0"}} ``` ## Results The response envelope contains search content in `data`, along with status and request metadata. Documented search fields include: - `cursor`: cursor for the next page. - `has_more`: `1` means more results; `0` means no more. - `business_data`: result items with `data_id`, `type`, and type-specific `data`. Result types are `1` for videos (`aweme_info`), `2` for users (`user_info`), `4` for music (`music_info`), and `6` for hashtags (`cha_info`). Depending on the result type, details may include video descriptions, author information, playback and cover URLs, engagement counts, user profiles, music titles, or hashtag participation statistics. These result-type codes are separate from the input `content_type` filter codes. The search payload is not strictly specified by the response schema and may be null; field availability and exact structure depend on the actual response.

SocialVideoAudio
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.65 credits/call

20.65 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes综合搜索请求体对象,用于设置搜索关键词、分页游标及标识、排序方式、发布时间、视频时长和内容类型筛选,以获取抖音视频、用户、音乐、话题等搜索结果。/ Request body object for mixed Douyin search results such as videos, users, music, and hashtags, containing the search keyword, pagination cursor and identifiers, sorting method, and publication-time, video-duration, and content-type filters.—
request_body.cursorintegerNo偏移游标,用于翻页,从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response0
request_body.keywordstringNo关键词 / Keyword猫咪
request_body.backtracestringNo翻页回溯标识,用于翻页,从上一次请求返回的响应中获取 / Backtrace for pagination, obtained from the last response""
request_body.search_idstringNo搜索ID,用于翻页,从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response""
request_body.sort_typestringNo排序方式:0=综合排序 1=最多点赞 2=最新发布 / Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest0
request_body.content_typestringNo内容类型:0=不限 1=视频 2=图片 3=文章 / Content type: 0=All, 1=Video, 2=Picture, 3=Article0
request_body.publish_timestringNo发布时间筛选:0=不限 1=最近一天 7=最近一周 180=最近半年 / Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year0
request_body.filter_durationstringNo视频时长过滤:0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上 / Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes0

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_search_fetch_multi_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "count": 10,
      "is_filter_search": 0,
      "keyword": "叠冒冒",
      "offset": 0,
      "query_correct_type": 1,
      "search_channel": "aweme_user_web",
      "search_source": "normal_search"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": [
    {
      "business_data": [
        {
          "data": {
            "ala_src": "user_card",
            "aweme_list": []
          },
          "data_id": "0",
          "type": 999
        }
      ]
    }
  ],
  "docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_multi_search_api_v1_douyin_search_fetch_multi_search_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "24944d3c-8f06-4b5d-87a3-798b1db582e5"
}

This example shows part of the response. Copied content is valid JSON.