Douyin Search Fetch Experience Search

20.65 credits/call
ae_douyin_search_fetch_experience_search

## Purpose Search Douyin's experience-oriented content, such as knowledge sharing, tutorials, tips, and guides, using a keyword. ## Inputs Provide a required `request_body` object. All fields inside it are optional: - `keyword`: Search text; defaults to `"猫咪"`. - `cursor`: Integer pagination cursor; defaults to `0`. - `search_id` and `backtrace`: String pagination identifiers; both default to `""`. - `sort_type`: `"0"` comprehensive ranking, `"1"` most likes, or `"2"` latest. - `publish_time`: `"0"` no limit, `"1"` last day, `"7"` last week, or `"180"` last half year. - `filter_duration`: `"0"` no limit, `"0-1"` within one minute, `"1-5"` one to five minutes, or `"5-10000"` more than five minutes. - `content_type`: `"0"` all, `"1"` video, `"2"` pictures, or `"3"` articles. All four filter fields are strings and default to `"0"`. For the first page, use `cursor: 0` and empty `search_id` and `backtrace`. For subsequent pages, use the pagination values returned by the previous response. ## Results Returns a response object with search results in `data`. Documented result structures include `business_data` blocks containing `aweme_list` video entries. Entries may provide content IDs, descriptions, publication timestamps, author profiles, music, hashtags, playback and cover URLs, engagement statistics, video status, and share links. Video duration, when supplied in `video.duration`, is measured in milliseconds. The search payload is not constrained to a fixed schema and may be null; field availability depends on the actual response.

Social
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抖音经验(知识、教程、攻略、分享等)内容搜索的请求体对象,包含搜索关键词 keyword、分页字段 cursor、search_id 和 backtrace,以及排序 sort_type、发布时间 publish_time、视频时长 filter_duration 和内容类型 content_type 筛选字段。 / Request body object for searching Douyin experience content, such as knowledge sharing, tutorials, guides, and tips. Contains the search keyword (keyword), pagination fields (cursor, search_id, backtrace), sorting (sort_type), and filters for publication time (publish_time), video duration (filter_duration), and content type (content_type).—
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_experience_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "backtrace": "",
      "content_type": "0",
      "cursor": 0,
      "filter_duration": "0",
      "keyword": "二十四节气旅行绘本 带读",
      "publish_time": "0",
      "search_id": "",
      "sort_type": "0"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "business_data": [
      {
        "data": {
          "aweme_info": {
            "author": {},
            "aweme_id": "7671100365945400817",
            "create_time": 1786067236,
            "desc": "#二十四节气    《二十四节气旅行绘本》——立秋"
          },
          "card_id": "douyin.doctype_aweme_video",
          "card_style_type": 1,
          "card_type": 1,
          "log_data": {
            "dcm": "search.natural.aweme_video.7671100365945400817.202611091729089EA4761D160F7874A998",
            "rank": "1",
            "search_id": "202611091729089EA4761D160F7874A998"
          },
          "ops": null
        },
        "data_id": "0_7671100365945400817",
        "type": 12
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_experience_search_api_v1_douyin_search_fetch_experience_search_post",
  "message": "Request successful. This request will incur a charge."
}

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