Douyin Creator Fetch Creator Hot Course

2.07 credits/call
ae_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.

AcademicSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
limitintegerNo每页数量/Items per page (建议24)24
orderintegerNo排序方式/Order type (1=推荐排序, 2=最受欢迎, 3=最新上传)1
offsetintegerNo偏移量/Offset0
category_idstring | nullNo精选专题分类ID/Selected topic category ID - 不传则为热门课程,传入则为精选专题 可选值/Available values: 6976547830546582816=知识品类, 6976547923849006336=生活品类, 6976547940311633165=娱乐品类, 6976547972108635404=美食品类, 6980288134957272352=正能量, 6980288181744766219=游戏品类, 6980288219548011776=通用—

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_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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.