Douyin Index Fetch Item Filter Options
Retrieve the available filters for video search before choosing search criteria. Input: No parameters are required; use an empty object (`{}`). Returns four option lists: - `categories`: video categories; each option's `id` is used as `category_id` in video search. - `duration_types`: duration filters; each option's `id` is used as `duration_type`. - `label_types`: video-type filters; each option's `id` is used as `label_type`. - `date_types`: publication-date filters; each option's `id` is used as `date_type`. Each option includes `id`, `name`, and `name_en` for identifying and displaying the choice. This tool retrieves filter options only; it does not return matching videos.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 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.
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_filter_options' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {}
}'{
"code": 200,
"data": {
"categories": [
{
"id": "0",
"name": "垂类不限",
"name_en": "All categories"
}
],
"date_types": [
{
"id": 0,
"name": "发布时间不限",
"name_en": "Any publish time"
}
],
"duration_types": [
{
"id": 0,
"name": "时长不限",
"name_en": "Any duration"
}
],
"label_types": [
{
"id": 0,
"name": "类型不限",
"name_en": "Any type"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_item_filter_options_api_v1_douyin_index_fetch_item_filter_options_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

