线报酷提供一套公开只读 API，无需申请密钥、无需登录，任何网站、App、脚本都可以直接调用，用于接入线报榜单、实时线报流、关键词与价格筛选、生活优惠。

一分钟上手

# 取七天榜前 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"

所有响应都是 JSON，统一信封：

{
  "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 提供，v1 保留至少 6 个月。

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

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