1. /api/v1/meta —— 能力清单

无参数。返回可用的榜单类型、可订阅的分类、价格筛选覆盖范围、限流参数，以及明确不提供的能力列表。

2. /api/v1/rank —— 榜单

参数	必填	说明
act	是	榜单类型，取值见下表
limit	否	条数 1~300，默认 20。limit ≤ 50 时不返回 content 字段（响应瘦身）

可用 act：yixiaoshi（一小时榜）、sanxiaoshi、liuxiaoshi、shierxiaoshi、ershisixiaoshi、sishibaxiaoshi、jintian、zuotian、qiantian、santian、wutian、qitian、shiwutian。

GET /api/v1/rank?act=qitian&limit=20

3. /api/v1/feed —— 分类最新线报

参数	说明
cate	分类别名或 ID（如 weibo / 10）；缺省为 all（全站流）
type	填 zdm 取「值得买」独立流。它的字段结构与分类流不同，见字段字典
limit	1~50，默认 20

重要：每个分类流最多保留 20 条（值得买 30 条），是"最新快照"而不是可分页的历史接口。需要历史请用榜单接口。

GET /api/v1/feed?cate=weibo
GET /api/v1/feed?type=zdm

4. /api/v1/search —— 关键词 + 价格筛选

参数	说明
q	关键词。多个词用换行、| 或 # 分隔，词之间是「或」的关系
kp	屏蔽词，命中的内容会被排除
mip / mxp	最低价 / 最高价
cate	限定分类（别名或 ID），可选
page / limit	页码（默认 1）/ 每页条数（1~50，默认 20）

价格筛选的适用范围：只有微博线报、好单线报、值得买这三类内容带价格。豆瓣、赚客吧等其他分类的商品信息里没有价格字段，对它们做价格筛选会得到空结果——这是数据本身的限制，不是接口故障。响应 meta.price_scope 会同时告知这一点。

至少要提供 q、kp、mip、mxp 之一，否则返回 400。

GET /api/v1/search?q=耳机&mip=50&mxp=200&page=1&limit=20
GET /api/v1/search?q=牛奶|酸奶&kp=包邮&cate=haodan

5. /api/v1/shenghuo —— 生活优惠

参数	说明
cate	活动分类
q	关键词（匹配活动名与描述）
page / pageSize	页码（默认 1）/ 每页条数（1~100，默认 20）
with_cates	填 1 时额外返回全部分类清单

每条记录都带 h5 字段（活动直达链接），无需再单独请求转链接口。

GET /api/v1/shenghuo?page=1&pageSize=20&with_cates=1