Douyin Trending Events & Topics Calendar (by Date Range)
omnial/douyin-billboard-fetch-hot-calendar-list
Returns Douyin's hot-events calendar for a given time window: trending event and topic titles, their category, active date range, and platform engagement status. Optionally narrowed by category code or city code; when nothing is scheduled in the requested window, the event/topic lists are left out of the response entirely rather than returned empty.
activeper callv2
Price
Up to $0.00205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Data source
Data from Douyin.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/douyin-billboard-fetch-hot-calendar-list" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/douyin-billboard-fetch-hot-calendar-list" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/douyin-billboard-fetch-hot-calendar-list", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/douyin-billboard-fetch-hot-calendar-list", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"start_date"
]
},
{
"required": [
"end_date"
]
},
{
"required": [
"category_code"
]
},
{
"required": [
"city_code"
]
}
],
"properties": {
"end_date": {
"type": "integer",
"default": 1735488000,
"description": "快照结束时间 格式10位时间戳"
},
"city_code": {
"type": "string",
"default": "",
"description": "城市编码，从城市列表获取，空为全部"
},
"start_date": {
"type": "integer",
"default": 1734902400,
"description": "快照开始时间 格式10位时间戳"
},
"category_code": {
"type": "string",
"default": "",
"description": "热点榜分类编码，从热点榜分类获取，空为全部"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"code": {
"type": "number",
"description": "0 on every real call observed."
},
"data": {
"type": "object",
"properties": {
"event_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "The event's own id."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Observed as an empty array on every real call."
},
"end_date": {
"type": "number",
"description": "Unix seconds."
},
"sentence": {
"type": "string",
"description": "Observed as an empty string on every real call."
},
"timeline": {
"type": "null",
"description": "Observed `null` on every real call."
},
"city_name": {
"type": "string",
"description": "City this event is scoped to, when the call is narrowed by `city_code`. Observed as an empty string on every real call (none passed `city_code`)."
},
"cover_url": {
"type": [
"string",
"null"
],
"description": "Cover image URL. Withheld (shaped to `null`) -- only whether an event has a cover image is observable, not the image itself."
},
"event_ids": {
"type": "null",
"description": "Observed `null` on every real event entry (unlike a topic's own `event_ids`)."
},
"hot_title": {
"type": "string",
"description": "The trending headline, in Chinese."
},
"parent_id": {
"type": "number",
"description": "The id of the topic this event rolls up under, or 0 for none."
},
"level_code": {
"type": "number",
"description": "Platform-assigned ranking tier."
},
"start_date": {
"type": "number",
"description": "Unix seconds."
},
"is_favorite": {
"type": "number",
"description": "0 or 1; observed 0 on every real call."
},
"publish_cnt": {
"type": "number",
"description": "0 observed on every real call."
},
"event_status": {
"type": "number",
"description": "-1 observed on every real call."
},
"category_name": {
"type": "string",
"description": "Content category, in Chinese, e.g. '美食' (food), '话题互动' (topic engagement)."
},
"related_topics": {
"type": "string",
"description": "Observed as an empty string on every real call."
}
},
"additionalProperties": true
},
"description": "Individual trending events, each tied to a parent topic via `parent_id`. ABSENT entirely -- not present as `null`, not `[]` -- when the requested date range has nothing scheduled. Do not rely on this key being present; check for its absence to detect \"nothing scheduled\", not for a `null` value."
},
"topic_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "number"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Observed as an empty array on every real call."
},
"end_date": {
"type": "number",
"description": "Unix seconds."
},
"sentence": {
"type": "string",
"description": "Observed as an empty string on every real call."
},
"timeline": {
"type": "null",
"description": "Observed `null` on every real call."
},
"city_name": {
"type": "string",
"description": "Observed as an empty string on every real topic entry."
},
"cover_url": {
"type": "string",
"description": "Observed as an empty string on every real topic entry."
},
"event_ids": {
"type": "array",
"items": {
"type": "number"
},
"description": "Ids of the events grouped under this topic."
},
"hot_title": {
"type": "string",
"description": "The topic headline, in Chinese."
},
"parent_id": {
"type": "number",
"description": "0 observed on every real call."
},
"level_code": {
"type": "number"
},
"start_date": {
"type": "number",
"description": "Unix seconds."
},
"is_favorite": {
"type": "number",
"description": "0 observed on every real call."
},
"publish_cnt": {
"type": "number",
"description": "0 observed on every real call."
},
"event_status": {
"type": "number",
"description": "-1 observed on every real call."
},
"category_name": {
"type": "string",
"description": "Observed as an empty string on every real topic entry."
},
"related_topics": {
"type": "string",
"description": "Observed as an empty string on every real call."
}
},
"additionalProperties": true
},
"description": "Parent topics that group one or more events (see each event's `parent_id`). ABSENT entirely -- not present as `null`, not `[]` -- when the requested date range has nothing scheduled, as for `event_list` above. Do not rely on this key being present; check for its absence to detect \"nothing scheduled\"."
}
},
"additionalProperties": true
},
"extra": {
"type": "object",
"properties": {
"now": {
"type": "number",
"description": "The upstream server's own clock at call time, unix milliseconds."
}
},
"description": "Call metadata.",
"additionalProperties": true
},
"message": {
"type": "string",
"description": "Observed as an empty string on every real call."
}
},
"description": "The calendar record. When nothing is scheduled for the requested date range, `data.event_list` and `data.topic_list` are ABSENT from the result entirely -- never present as `null` or `[]` (see `data` below).",
"additionalProperties": true
}