Douyin Creator Fetch Creator Hot Course
Retrieve hot courses or curated topic courses from the Douyin creator platform. All inputs are optional: - order: Integer sorting option; 1 = recommended (default), 2 = most popular, 3 = latest upload. - limit: Number of items per page, from 1 to 100; default and recommended value: 24. - offset: Nonnegative integer starting offset; default: 0. - category_id: Optional category ID supplied as a string. Omit it for hot courses, or supply one of the following IDs for curated topic courses: - 6976547830546582816: Knowledge - 6976547923849006336: Lifestyle - 6976547940311633165: Entertainment - 6976547972108635404: Food - 6980288134957272352: Positive Energy - 6980288181744766219: Gaming - 6980288219548011776: General Returns the requested hot-course or curated-topic course data in the response's data field. The detailed course-data structure is not specified. This tool retrieves course information; it does not enroll you in a course or play course content.
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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
limit | integer | No | 每页数量/Items per page (建议24) | 24 |
order | integer | No | 排序方式/Order type (1=推荐排序, 2=最受欢迎, 3=最新上传) | 1 |
offset | integer | No | 偏移量/Offset | 0 |
category_id | string | null | No | 精选专题分类ID/Selected topic category ID - 不传则为热门课程,传入则为精选专题 可选值/Available values: 6976547830546582816=知识品类, 6976547923849006336=生活品类, 6976547940311633165=娱乐品类, 6976547972108635404=美食品类, 6980288134957272352=正能量, 6980288181744766219=游戏品类, 6980288219548011776=通用 | — |
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_creator_fetch_creator_hot_course' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"limit": 20,
"offset": 0,
"order": 2
}
}'{
"code": 200,
"data": {
"course_list": [
{
"collected_count": 100500,
"hot_order": 8,
"id": "7049291585091063053",
"is_collected": false,
"item": {
"Cover": {
"height": 960,
"uri": "tos-cn-i-dy/2ef36b04166e496a84ff2e06d6d8206a",
"url_list": [],
"width": 540
},
"author": {
"avatar_larger": {},
"avatar_medium": {},
"avatar_thumb": {},
"birthday": "***",
"nickname": "抖音作者助手",
"short_id": "2941976066"
},
"author_user_id": 92769419069,
"aweme_id": "7049291585091063053",
"aweme_type": 4,
"cha_list": [
{}
]
}
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Creator-API/fetch_creator_hot_course_api_v1_douyin_creator_fetch_creator_hot_course_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "a0355af8-1bd3-4418-89ec-0a74d2a4cf4a"
}This example shows part of the response. Copied content is valid JSON.

