Connect AITVHot to your agent
MCP, RSS, API — three ways into the same data: picks, the hot board, the daily, the weekly and the monthly. Choose the one that fits your tool. Anonymous and read-only — no account, no API key.
Anonymous GET, ready to call
No token. Cross-origin browser calls, curl and the default HTTP client in any language all work. Paths are under /api/v1; fields and error codes follow OpenAPI.
curl --compressed 'https://aitvhot.top/api/v1/items?mode=selected&window=24h&limit=20'Filter by category
Add category to an items request to take one category; omit it for all of them. Returned items use the same category values as the table.
| Category | Parameter |
|---|---|
| AI video models | category=video-model |
| AI creation tools | category=tool |
| Platforms | category=platform |
| Regulation | category=policy |
| Industry | category=industry |
| Tutorials | category=tip |
| Opinion | category=opinion |
Cheaper, and faster
- 01Compress
Add
--compressedto curl; other clients should enable gzip or br. Compressed JSON is a quarter to an eighth of the size. - 02Send the ETag
Save the response ETag and send
If-None-Matchnext time. If nothing changed, the response is 304 with no body. - 03Match the pace
News and the hot board, at most once a minute. The daily, once after 08:00; the weekly and monthly, once after they publish. When paging back, stop at an item you already have.
How often it changes: news arrives through the day, picks change a few times to a few dozen times a day, and there is one daily at 08:00, one weekly on Monday at 10:00 and one monthly on the 1st at 10:30 (Beijing time).
Endpoints
| Path | What it's for | How often |
|---|---|---|
| News | ||
/api/v1/items | Picks, or all news from the last 7 days, filterable by category, window and keyword | At most once a minute |
| Hot board and events | ||
/api/v1/hot-topics | Hot board, top 10 | At most once a minute |
/api/v1/stories/{publicId} | An event's report timeline, AI digest and related events | When you need it |
| Daily | ||
/api/v1/dailies/latest | The latest daily | Once after 08:00 |
/api/v1/dailies/{date} | The daily for a date. A retraction drops the citation | After the cache expires, check the ETag before use |
/api/v1/dailies | Index of daily dates | Once a day |
| Weekly and monthly | ||
/api/v1/weeklies/latest | The latest weekly: lead, overview and the week's points, by section | Once after Monday 10:00 |
/api/v1/weeklies/{week} | One week, ISO form such as 2026-W39. A retraction drops the citation | After the cache expires, check the ETag before use |
/api/v1/weeklies | Weekly index | Once a week |
/api/v1/monthlies/latest | The latest monthly | Once after the 1st at 10:30 |
/api/v1/monthlies/{month} | One month, such as 2026-09 | After the cache expires, check the ETag before use |
/api/v1/monthlies | Monthly index | Once a month |
| For an AI assistant | ||
/api/v1/agent | A guide for agents. The addresses it lists return edited Chinese Markdown | When you need it |
| Full pick sync | ||
/api/v1/selected/snapshot | Every current pick, paged until you have them all | Only the first time |
/api/v1/selected/changes | Adds, edits and unpicks after that | Every few minutes |
Common uses
# First time: save the ETag from the response headers
curl --compressed -i 'https://aitvhot.top/api/v1/items?mode=selected&window=24h&limit=20'
# After that, at most once a minute, with the ETag. 304 means nothing changed
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://aitvhot.top/api/v1/items?mode=selected&window=24h&limit=20'To page backward, pass page.nextCursor back as cursor and stop when you reach an item you already have. Don't re-walk all 7 days every time.
When something fails
- 400
- Bad parameters: fix them from the OpenAPI and the returned code. Don't automatically widen the query. An invalid cursor, or one that slid out of the window, is invalid_cursor — start again from page one.
- 409
- snapshot_required: the increment can't be continued safely. Take a full snapshot again.
- 429
- Too frequent: wait for Retry-After. Don't retry in parallel.
- 5xx
- Back off exponentially and keep the last successful result. The public service doesn't promise an SLA.
An anonymous call is not a license for every use. See the Terms of use.