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

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

2. /api/v1/articles —— 公开文章分页列表

参数	说明
cate	公开分类别名或 ID，可选；未传为全站普通文章
page / limit	从 1 开始的页码（1~100）/ 每页 1~50 条，默认 20
since / until	发布时间范围 Unix 秒，可选，包含边界

仅返回已公开的普通文章，不返回页面、草稿或审核中的内容。结果按发布时间倒序、文章 ID 倒序稳定排序，has_more 表示是否还有下一页。

GET /api/v1/articles?cate=weibo&page=1&limit=20
GET /api/v1/articles?since=1791800000&until=1791890000

3. /api/v1/article —— 单篇公开文章详情

参数	说明
id	必填文章 ID
with_html	填 1/true/yes 时附清洗后的 content_html

仅返回已公开的普通文章；不存在、页面、草稿和审核中的文章统一返回 404 article_not_found。默认返回正文纯文本，需要展示态富文本时再开启 with_html。

GET /api/v1/article?id=7300000
GET /api/v1/article?id=7300000&with_html=1

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

参数	必填	说明
act	是	榜单类型，取值见下表
limit	否	条数 1~300，默认 20。limit ≤ 50 时不返回 content 字段（响应瘦身）
with_html	否	填 1/true/yes 时每条附清洗后的 content_html

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

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

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

参数	说明
cate	分类别名或 ID（如 weibo / 10）；缺省为 all（全站流）
type	填 zdm 取「值得买」独立流。它的字段结构与分类流不同，见字段字典
limit	1~50，默认 20
with_html	填 1 时每条额外返回 content_html（正文富文本，值得买独立流不适用）

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

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

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

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

价格筛选的适用范围：此搜索端点只查本站文章索引，只有微博线报、好单线报的文档写入价格。值得买是独立数据源，通过 /api/v1/feed?type=zdm 获取，不由此搜索端点检索。对其他分类做价格筛选会得到空结果。响应 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

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

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

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

生活优惠响应的 Cache-Control 与 meta.cache_ttl 当前均为 60 秒；文章分页列表 30 秒，文章详情 60 秒。