Douyin Index Fetch Item Query
Search the Douyin Index video library by keyword and optionally narrow results by category, publication time, video quality label, and duration. Inputs: - query: Required search keyword (string), for example "food". - category_id: Optional category ID (string); default "0" means all categories. Examples: "628" = Food, "629" = Travel, "615" = Technology. - date_type: Optional integer publication filter; 0 = any time (default), 3 = last 3 days, 7 = last 7 days, 30 = last month. - label_type: Optional integer quality label; 0 = any (default), 1 = low-follower hit, 2 = high completion rate, 3 = high follower growth, 4 = high like rate. - duration_type: Optional integer duration filter; 0 = any (default), 1 = 0–15 seconds, 6 = 15–60 seconds, 7 = 60–120 seconds, 8 = 120–180 seconds, 9 = over 180 seconds. Current filter choices can be retrieved through the filter-options lookup when available; category examples above are not a complete list. Returns a response with search results in data. Documented video information includes ID, title, cover, duration, publication time, play count, likes, comments, shares, and author ID, nickname, and follower count. The result data has no fixed detailed schema, so available fields depend on the returned records. Results cover the Douyin Index video library, not necessarily all Douyin videos. Example: {"query":"food","category_id":"628","date_type":7,"duration_type":6,"label_type":2} searches the Food category for matching videos published in the last 7 days, lasting 15–60 seconds, with the high-completion-rate label.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Each call is charged a fixed fee of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | 搜索关键词/Search keyword | — |
date_type | integer | No | 发布时间类型(可通过 fetch_item_filter_options 获取)/Date type (get from fetch_item_filter_options), 0=不限/unlimited | 0 |
label_type | integer | No | 视频类型(可通过 fetch_item_filter_options 获取)/Label type (get from fetch_item_filter_options), 0=不限/unlimited | 0 |
category_id | string | No | 垂类ID(可通过 fetch_item_filter_options 获取)/Category ID (get from fetch_item_filter_options), 0=全部/all | 0 |
duration_type | integer | No | 时长类型(可通过 fetch_item_filter_options 获取)/Duration type (get from fetch_item_filter_options), 0=不限/unlimited | 0 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_index_fetch_item_query' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"category_id": "0",
"date_type": 7,
"duration_type": 0,
"label_type": 0,
"query": "治愈系风景 文案"
}
}'{
"code": 200,
"data": {
"data": [
{
"avatarUrl": "https://p6-byteindex-sign.byteimg.com/aweme-avatar/tos-cn-i-0813_ogBXlA5AeIEAcNEfzCEAoxB0AXLiiAgKCg5bTw~tplv-obj.image?rk3s=c8d089e8&x-expires=1794405788&x-signature=uHC0k%2B8Hpv3ioJX2sArzfZf1vzE%3D",
"createTime": "2026-11-09 20:06:51",
"duration": 20,
"fans": 10130,
"title": "我想娶你,想日日吃你亲手做的饭,想牵着你的手,慢慢逛遍大街小巷。想被你好好爱着,就像我爱着你一样。想清晨醒来,一转头就能看见你。这些不是动听的情话,是我藏在心底最真切的心愿。#情感鸡汤 #情感共鸣 #治愈系风景 #文案",
"url": "https://www.douyin.com/video/7706142038648012650"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_item_query_api_v1_douyin_index_fetch_item_query_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"category_id": "0",
"date_type": "7",
"duration_type": "0",
"label_type": "0",
"query": "治愈系风景 文案"
}
}This example shows part of the response. Copied content is valid JSON.

