跳到主要内容
Docs/Api Reference/Research

Research API

Research endpoints power the Discover features — keyword discovery, BSR analysis, blue-ocean opportunity finder, competitor reverse engineering.

Keyword Discovery

MethodPathDescription
POST`/api/v1/research/keywords`Discover keywords from a seed
POST`/api/v1/research/keywords/suggest`Suggest from a category
GET`/api/v1/research/keywords/trending`Trending right now

BSR & Blue Ocean

MethodPathDescription
POST`/api/v1/research/bsr`Top sellers for a category
POST`/api/v1/research/blueocean`Find under-served niches
POST`/api/v1/research/competitor-reverse`Reverse-engineer a competitor URL

Niche Score

MethodPathDescription
POST`/api/v1/research/niche-score`Score a niche on 5 dimensions

Reports

MethodPathDescription
GET`/api/v1/research/reports`List saved reports
GET`/api/v1/research/reports/:id`Get one

Every response uses the standard envelope:

{
  "success": true,
  "data": { /* resource or array */ },
  "meta": { "total": 100, "cursor": "...", "hasMore": true },
  "error": { "code": "ERROR_CODE", "message": "Human readable" }
}

error is omitted on success; meta is omitted when not paginating.

Rate Limits

Subject to the standard 200 req/min/tenant authenticated limit. See [Rate Limits](/docs/api-reference/rate-limits) for full details and the per-endpoint overrides.

← Back to Docs