keyword-browsing

Keyword Browsing

Browse and explore topic/keyword opportunities.

List Topics

GET /v1/topics

Query parameters:

Param	Type	Default	Description
limit	number	20	Results per page (max 100)
cursor	string	—	Cursor for next page
industry	string	—	Filter by industry
minScore	number	—	Minimum topic score
maxScore	number	—	Maximum topic score
sortBy	string	—	Sort field

Response:

{
  "topics": [...],
  "pagination": {
    "cursor": "next_cursor_value",
    "hasMore": true
  }
}

Get Topic by ID

GET /v1/topics/:id

Returns full topic data including keywords, search volume, and scoring.

List Industries

GET /v1/topics/industries

Returns all unique industries the user has topics in.

Topic Statistics

GET /v1/topics/stats

Returns topic counts by industry and score distribution.

Deep Keyword Research

POST /v1/topics/:id/research-keywords

Triggers AI-powered keyword research for a specific topic. Returns enriched keyword data.

Discover New Topics

POST /v1/topics/discover

Body:

{
  "industry": "SaaS Marketing",
  "maxTopics": 5
}

Field	Type	Required	Description
industry	string	Yes	Industry to discover topics for
maxTopics	number	No	Number of topics (1-20, default 5)

Response (202 Accepted):

{
  "jobId": "uuid",
  "status": "queued",
  "statusUrl": "/api/v1/jobs/{jobId}"
}

Poll GET /v1/jobs/:jobId until completed. See article-generation skill for polling pattern.

Workflows

Browse high-scoring topics in an industry

1. GET /v1/topics?industry=SaaS%20Marketing&minScore=70&sortBy=score&limit=20

Discover topics for a new industry

1. POST /v1/topics/discover with { "industry": "Fintech", "maxTopics": 10 }
2. Poll GET /v1/jobs/:jobId until completed
3. GET /v1/topics?industry=Fintech to browse discovered topics

Find topics ready for article generation

1. GET /v1/topics?minScore=60&limit=50
2. Present high-scoring topics to user for selection