线报酷提供一套公开只读 API，无需申请密钥、无需登录，任何网站、App、脚本都可以直接调用，用于接入线报榜单、实时线报流、关键词与价格筛选、生活优惠。这个能干什么：用五分钟跑通第一次请求，拿到能用的数据。需要什么：一个能发 HTTP 请求的工具（浏览器、curl、任意语言的 HTTP 库都行）和一点 JSON 常识。

一分钟上手

# 取七天榜前 20 条
curl "https://new.xianbao.fun/api/v1/rank?act=qitian&limit=20"

# 取微博线报最新 20 条
curl "https://new.xianbao.fun/api/v1/feed?cate=weibo"

# 搜 50~200 元之间的耳机
curl "https://new.xianbao.fun/api/v1/search?q=耳机&mip=50&mxp=200"

# 频道流 + 正文 HTML（图片已做防盗链处理，可直接嵌入页面）
curl "https://new.xianbao.fun/api/v1/feed?cate=weibo&limit=5&with_html=1"

成功响应统一是 JSON 信封（出错时是 { "code": 4xx, "error": "...", "msg": "..." }，没有 data/meta）：

{
  "code": 0,
  "msg": "",
  "data": { ... },
  "meta": { "api_version": "v1", "generated_at": 1791895921 }
}

五个接口

接口	用途
/api/v1/meta	能力清单：可用榜单、可订阅分类、限流参数、明确不提供的能力
/api/v1/rank	榜单（一小时榜到十五天榜，共 13 种）
/api/v1/feed	各分类最新线报流
/api/v1/search	关键词 + 屏蔽词 + 价格区间 + 分类筛选
/api/v1/shenghuo	生活优惠活动（含转链地址）

建议每次对接前先请求一次 /api/v1/meta，它会返回当时真实可用的参数取值。

三条约定

• 限流：每个 IP、每个接口各 60 次/分钟。超限返回 HTTP 429 与 Retry-After，请按该头退避重试，不要立即重试。
• 跨域：允许任意来源直接请求（Access-Control-Allow-Origin: *），浏览器里可以直接 fetch。
• 版本：字段只增不减；破坏性变更会以 /api/v2 提供。

常见问题

Q：为什么返回 404 unknown_category？
只开放现役可发布的分类，公告区、我的关注位、未上线分类都不在公开列表里。先请求 /api/v1/meta 看可用的分类别名。

Q：limit 最大能取多少？
榜单 1~300；分类流和搜索 1~50；生活优惠每页 1~100。榜单在 limit ≤ 50 时不返回 content 字段，需要正文就取更大条数或加 with_html=1。

下一步：接口参考、字段字典、错误码与限流。

相关：万能API接口 讲的是推送渠道的 Webhook 对接，与本站开放 API 不是一回事，注意区分。