# Douyin hot events calendar

Douyin: fetch hot calendar list (billboard)

|  |  |
| --- | --- |
| Tool id | `tikhub.x-douyin-billboard-fetch-hot-calendar-list` |
| Platform | [Douyin](https://www.orcarouter.ai/tools/douyin.md) |
| Capability | [Trending \& hot lists](https://www.orcarouter.ai/tools/douyin/trending-list.md) |
| Price | $0.0011 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | scraped |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `category_code` | string | no | 热点榜分类编码，从热点榜分类获取，空为全部 |
| `city_code` | string | no | 城市编码，从城市列表获取，空为全部 |
| `end_date` | integer | no | 快照结束时间 格式10位时间戳 |
| `start_date` | integer | no | 快照开始时间 格式10位时间戳 |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/tikhub.x-douyin-billboard-fetch-hot-calendar-list/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/tikhub.x-douyin-billboard-fetch-hot-calendar-list/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Douyin brand trending ranking](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-app-v3-fetch-brand-hot-search-list.md) | — | $0.0011 per call | OK |
| [Douyin brand trending ranking by category id](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-app-v3-fetch-brand-hot-search-list-detail.md) | — | $0.0011 per call | OK |
| [Douyin trending searches by board type](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-app-v3-fetch-hot-search-list.md) | — | $0.0011 per call | OK |
| [Douyin music trending chart](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-app-v3-fetch-music-hot-search-list.md) | — | $0.0011 per call | OK |
| [Douyin hot account video analysis by secUid](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-billboard-fetch-hot-account-item-analysis-list.md) | — | $0.0011 per call | OK |
| [Douyin hot accounts ranking](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-billboard-fetch-hot-account-list.md) | — | $0.0011 per call | OK |
| [Douyin hot account growth trends by secUid](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-billboard-fetch-hot-account-trends-list.md) | — | $0.0011 per call | OK |
| [Douyin hot calendar event details by event id](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-billboard-fetch-hot-calendar-detail.md) | — | $0.0011 per call | OK |
| [Douyin trending categories by board type](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-billboard-fetch-hot-category-list.md) | — | $0.0011 per call | OK |
| [Douyin video engagement trends by video id](https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-billboard-fetch-hot-item-trends-list.md) | — | $0.0011 per call | OK |

Showing the first 10 of 25.

## FAQ

### How much does Douyin hot events calendar cost?

Douyin hot events calendar costs $0.0011 per call: 1,000 calls cost $1.10.

### What does a $10 budget buy with Douyin hot events calendar?

About 9090 calls at $0.0011 per call.

### What inputs does Douyin hot events calendar need?

It has no required inputs.

### How do I call Douyin hot events calendar?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/douyin/trending-list/x-douyin-billboard-fetch-hot-calendar-list