GET福利列表（每条的 url 是详情页地址 /deals/<slug>）

GET/api/v1/deals

本页目录

T122：折扣对外可见，新增 planFamily 与 landing；推荐 landing.url（套餐或工具页福利锚点）。

参数

参数	类型	必填	说明
`type`	string	否	福利类型。当前使用 api-free-quota（API 免费额度）、limited-free-model（限时免费模型）、discount（首购与限时折扣）三类；new-model-credit、student、referral、platform-subsidy 是历史旧值，只为已有数据保留，新数据不再使用，不建议用来筛选。；可选值：api-free-quota / limited-free-model / discount / new-model-credit / student / referral / platform-subsidy
`status`	string	否	状态；不传时默认只返回「进行中」（live + ending）；可选值：live / ending / all
`endsWithinDays`	integer	否	只看 N 天内结束的福利
`verified`	string	否	是否只看编辑核实过的，填 true 或 false；可选值：true / false
`product`	string	否	相关产品的 slug，只看某个产品的福利
`page`	integer	否	页码，从 1 开始
`pageSize`	integer	否	每页条数，默认 20，最大 100

所有接口匿名可用，按 IP 限流 60 次/分钟；需要提高额度时，可在请求头带 X-API-Key。

bash

curl "https://tiangongkaiwuai.cn/api/v1/deals?type=discount&status=live&endsWithinDays=3&verified=true&product=doubao&page=1&pageSize=20"

状态码	含义
400	查询参数不合法
429	请求过于频繁（带 X-API-Key 可提额）

更新于 2026-10-29来源：由 openapi.json 自动生成，请勿手改