线报酷提供一套公开只读 API，用来把站内的线报榜单、各频道最新线报、关键词与价格筛选、生活优惠接入到你自己的网站、App、机器人或脚本里。这个能干什么：让别的程序直接取线报数据做二次展示或自动处理。需要什么：会发一个 HTTP GET 请求即可，不用注册、不用密钥；只有“按我自己账号的规则取命中流”才需要登录后生成的个人密钥。

不需要申请，不需要密钥，也不需要登录。只要发一个 HTTP GET 请求就能拿到 JSON 数据，浏览器里也能直接跨域调用。另外还有一组带密钥的个人订阅接口（按你的账号输出你自己的关注命中流、推送命中流），见 个人订阅与扩展端点。

它和「万能API接口」不是一回事

知识库里的 万能API接口 讲的是推送渠道——把线报推到你的 QQ／钉钉／企业微信，是"线报酷主动发给你"。本分类讲的是开放 API——你主动来线报酷取数据。两者方向相反，别混淆。

接口一览

接口	能拿到什么
GET /api/v1/rank	榜单：一小时榜 / 三小时榜 / … / 今天 / 七天 / 十五天，共 13 种
GET /api/v1/feed	指定频道的最新线报（微博、好单、豆瓣各组、赚客吧、小嘀咕…）以及值得买独立流
GET /api/v1/search	按关键词、屏蔽词、价格区间、分类检索线报
GET /api/v1/shenghuo	生活优惠活动（含活动直达链接）
GET /api/v1/meta	能力清单：当前可用的榜单、频道、限流额度，以及明确不提供的能力
GET /rss.php	全站/分类/标签/关键词 RSS 订阅（公共，无需密钥）

先跑通一句话

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

用之前请先知道四件事

• 限流：每个 IP、每个接口各 60 次/分钟。超了返回 429，请按响应里的 Retry-After 等待，不要立刻重试。
• 价格筛选有范围：只有微博线报、好单线报、值得买三类内容带价格。对豆瓣、赚客吧做价格筛选会得到空结果——这是数据本身的限制，不是接口坏了。
• 频道流是最新快照：每个频道最多保留 20 条（值得买 30 条），拿到的是"此刻最新的这些"，要历史数据请用榜单接口。
• 要正文 HTML 就加 with_html=1：榜单/频道流/搜索三个接口都支持，返回的正文已做图片防盗链处理（带 referrerpolicy="no-referrer"、微博走搜狗 CDN、豆瓣等走站内代理），可直接嵌入你的页面。不传该参数时响应与旧版完全一致。

详细文档

开放 API 快速开始	五分钟接入，含完整示例与返回样例
开放 API 接口参考	五个接口的参数逐个说明
开放 API 字段字典	每个返回字段的含义与类型
开放 API 错误码与限流	错误码、限流响应头、缓存建议、不提供的能力
开放 API：个人订阅与扩展端点	我的关注/推送命中流（uid+密钥）、RSS 全站订阅、榜单 JSON

常见问题

Q：调用要注册或申请 Key 吗？
不要。上面五个 /api/v1 接口与 /rss.php 都是公开只读的，直接 GET。只有“按我自己的关注/推送规则取命中流”才需要账号里的个人密钥。

Q：为什么搜豆瓣/赚客吧时价格筛选是空的？
价格字段只存在于微博线报、好单线报、值得买三类内容，其他分类本身没有价格，不是接口坏了。

Q：可以拿来实时推送吗？
不提供 SSE 长连接。需要接近实时，可以按 meta.cache_ttl（频道流 10 秒）轮询；真正要“新线报主动推送到手机”，请用站内的推送规则。

当前版本 v1。字段只增不减；如将来有破坏性变更会另开 v2。