线报酷提供一套公开只读 API，用来把站内的线报榜单、各频道最新线报、关键词与价格筛选、生活优惠接入到你自己的网站、App、机器人或脚本里。

不需要申请，不需要密钥，也不需要登录。只要发一个 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	能力清单：当前可用的榜单、频道、限流额度，以及明确不提供的能力

先跑通一句话

# 七天榜前 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 条），拿到的是"此刻最新的这些"，要历史数据请用榜单接口。

详细文档

开放 API 快速开始	五分钟接入，含完整示例与返回样例
开放 API 接口参考	五个接口的参数逐个说明
开放 API 字段字典	每个返回字段的含义与类型
开放 API 错误码与限流	错误码、限流响应头、缓存建议、不提供的能力

当前版本 v1。字段只增不减；如将来有破坏性变更会另开 v2，v1 至少保留 6 个月。