Skip to content
AGENT ACCESS

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.

UpVersion 4.0.0Anonymous, read-only · no key
REST API · 4.0.0

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.

First request
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.

CategoryParameter
AI video modelscategory=video-model
AI creation toolscategory=tool
Platformscategory=platform
Regulationcategory=policy
Industrycategory=industry
Tutorialscategory=tip
Opinioncategory=opinion

Cheaper, and faster

  1. 01
    Compress

    Add --compressed to curl; other clients should enable gzip or br. Compressed JSON is a quarter to an eighth of the size.

  2. 02
    Send the ETag

    Save the response ETag and send If-None-Match next time. If nothing changed, the response is 304 with no body.

  3. 03
    Match 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

PathWhat it's forHow often
News
/api/v1/itemsPicks, or all news from the last 7 days, filterable by category, window and keywordAt most once a minute
Hot board and events
/api/v1/hot-topicsHot board, top 10At most once a minute
/api/v1/stories/{publicId}An event's report timeline, AI digest and related eventsWhen you need it
Daily
/api/v1/dailies/latestThe latest dailyOnce after 08:00
/api/v1/dailies/{date}The daily for a date. A retraction drops the citationAfter the cache expires, check the ETag before use
/api/v1/dailiesIndex of daily datesOnce a day
Weekly and monthly
/api/v1/weeklies/latestThe latest weekly: lead, overview and the week's points, by sectionOnce after Monday 10:00
/api/v1/weeklies/{week}One week, ISO form such as 2026-W39. A retraction drops the citationAfter the cache expires, check the ETag before use
/api/v1/weekliesWeekly indexOnce a week
/api/v1/monthlies/latestThe latest monthlyOnce after the 1st at 10:30
/api/v1/monthlies/{month}One month, such as 2026-09After the cache expires, check the ETag before use
/api/v1/monthliesMonthly indexOnce a month
For an AI assistant
/api/v1/agentA guide for agents. The addresses it lists return edited Chinese MarkdownWhen you need it
Full pick sync
/api/v1/selected/snapshotEvery current pick, paged until you have them allOnly the first time
/api/v1/selected/changesAdds, edits and unpicks after thatEvery few minutes

Common uses

bash
# 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.