开发者 API

通过 REST API 以编程方式获取 ProfitSearcher 的三类数据：风向标（signals）、需求缺口（needs）、深度报告（reports）。适合接入你自己的选品工具、数据看板或 AI 工作流。

快速开始

1. 登录后，在仪表板底部的「开发者 API」卡片创建一个 API Key（完整 Key 只显示一次，请立即保存）
2. 请求时通过 Header 携带 Key（两种方式任选其一）：

curl "https://www.profitsearcher.com/api/v1/needs?locale=zh&per_page=5" -H "Authorization: Bearer ps_live_xxxxxxxx..."

# 或使用 X-API-Key 头
curl "https://www.profitsearcher.com/api/v1/signals" -H "X-API-Key: ps_live_xxxxxxxx..."

端点一览

通用参数

• locale：zh（默认）或 en
• page：页码，默认 1（仅列表端点）
• per_page：每页条数，默认 20，最大 100（仅列表端点）

响应格式

成功响应：

{
  "data": [],
  "meta": { "total": 42, "page": 1, "per_page": 20, "generated_at": "2026-07-05T00:00:00Z" }
}

错误响应：

{ "error": { "code": "rate_limited", "message": "Daily request limit reached." } }

每个成功响应都带 X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset 响应头。

额度与内容分层

• 免费用户：每个账号一共 10 次请求（一次性总额度，跨所有 Key 累计，用完不再重置）
• 付费会员：每账号每日 10 次请求（跨所有 Key 累计，每日 UTC 0 点重置），且报告详情返回 content_markdown 全文
• 免费 Key 请求付费报告详情时，响应不含全文，并带 "content_locked": true
• 免费额度用完返回 429（需升级会员）；会员超出当日额度返回 429，每日 UTC 0 点重置
• 每个账号最多同时持有 5 个活跃 Key，可随时在仪表板撤销

错误码

内容发布或更新后，API 数据会立即刷新（与网页共享同一套缓存失效机制）。