Skip to content
FOR AGENTS

Connect BITHOT to your agent

Agent Skill, MCP, RSS, API — four ways to read the same data: picks, hot list, daily, weekly, and monthly reports. Anonymous read-only, no API key.

All systems goVersion 5.0.0Anonymous · read-only · no key
EasiestAgent SkillInstall once — it keeps workingMCPOne URL, extra toolsRSSCopy a URL into your readerREST APIAnonymous GET for your own code

Copied configs include a browser-generated anonymous id used only to merge stats — not an account or key. Clearing site data issues a new one. See the privacy notice.

REST API · 5.0.0

Anonymous GET — ready to call

No token. Browsers, curl, and ordinary HTTP clients can call it. Paths live under /api/v1; fields and error codes follow OpenAPI.

First request
curl --compressed 'https://bithot.news/api/v1/items?mode=selected&window=24h&limit=20'

Cheaper and faster

  1. 01
    Compress

    Add --compressed to curl, or enable gzip/br. JSON shrinks to about 1/4–1/8.

  2. 02
    Send the ETag

    Keep the ETag and send If-None-Match next time. Unchanged content returns 304 with no body.

  3. 03
    Poll on a cadence

    Items and the hot list: at most once a minute. Daily after Daily at 07:00 (Beijing time); weekly and monthly after they publish. Stop paging when you hit a row you already have.

How often it changes: items arrive all day; picks change several to dozens of times a day; daily Daily at 07:00 (Beijing time), weekly Mondays at 10:00, monthly 1st of each month at 10:30.

Endpoints

PathWhat it’s forHow often
资讯
/api/v1/items精选或最近 7 天全部动态，可按分类、时间窗、关键词筛最快 1 分钟一次
热点与事件
/api/v1/hot-topics当前热点榜 Top 10最快 1 分钟一次
/api/v1/stories/{publicId}一个事件的报道时间线、AI 综述和关联事件需要时
日报
/api/v1/dailies/latest最新一期日报Daily at 07:00 (Beijing time) 后一次
/api/v1/dailies/{date}指定日期日报；撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/dailies日报日期索引每天一次
周报与月报
/api/v1/weeklies/latest最新一期周报：头条、总述和一周重点，按栏目分好Mondays at 10:00 后一次
/api/v1/weeklies/{week}指定一周，ISO 周如 2026-W39；撤稿会移除引用缓存过期后使用前验证 ETag
/api/v1/weeklies周报索引每周一次
/api/v1/monthlies/latest最新一期月报1st of each month at 10:30 后一次
/api/v1/monthlies/{month}指定月份，如 2026-09缓存过期后使用前验证 ETag
/api/v1/monthlies月报索引每月一次
给 AI 助手
/api/v1/agent给 Agent 的使用说明，列出的地址返回整理好的中文 Markdown；Agent Skill 用的就是它们需要时
完整精选同步
/api/v1/selected/snapshot当前全部精选，分页一次拿全只在第一次
/api/v1/selected/changes之后的新增、修改和撤选几分钟一次

常见用法

bash
# 第一次：保存响应头里的 ETag
curl --compressed -i 'https://bithot.news/api/v1/items?mode=selected&window=24h&limit=20'
# 之后最快每分钟一次，带上 ETag；返回 304 就是没变化
curl --compressed -i -H 'If-None-Match: <上次的 ETag>' 'https://bithot.news/api/v1/items?mode=selected&window=24h&limit=20'

需要往回翻页时，把 page.nextCursor 作为 cursor 传回去，翻到已经有的那条就停，不要每次把 7 天重翻一遍。

出错了怎么办

400
参数不对：按 OpenAPI 和返回的 code 修正，不要自动换成更宽的查询。cursor 无效或滑出时间窗返回 invalid_cursor，从第一页重来。
409
snapshot_required：增量没法安全续上，重新取一次完整快照。
429
请求太密：按 Retry-After 等待，不要并发重试。
5xx
指数退避，先用上次成功的结果；公开服务不承诺 SLA。

能匿名调用不等于所有用途都获许可，见Terms of use。