SEO Intelligence API

The largest API group, covering keyword research, campaign planning, content queue management, Scout Bot, content strategies, and SEO analysis tools.

Prefix: /api/seo

Endpoints

Keyword Research

Method	Path	Description	Role
POST	/keywords/explore	Explore keyword ideas from Google Ads API	Editor+
POST	/keywords/deep-explore	Deep exploration with expanded metrics and clustering	Editor+

Keyword Plans

Method	Path	Description	Role
GET	/keyword-plans	List all keyword plans	Editor+
GET	/keyword-plans/{id}	Get keyword plan details	Editor+
POST	/keyword-plans	Create a keyword plan (max 15 keywords)	Editor+
PUT	/keyword-plans/{id}	Update a keyword plan (blocked if strategies exist)	Editor+
DELETE	/keyword-plans/{id}	Delete a keyword plan	Editor+

Saved Keywords

Method	Path	Description	Role
GET	/saved-keywords	List saved keywords for the environment	Editor+
POST	/saved-keywords	Save a keyword from research results	Editor+
POST	/saved-keywords/bulk	Save multiple keywords at once	Editor+
DELETE	/saved-keywords/{id}	Delete a saved keyword	Editor+

Campaign Planners

Method	Path	Description	Role
GET	/planners	List campaign planners (includes strategy readiness)	Editor+
GET	/planners/{id}	Get planner details	Editor+
POST	/planners	Create a campaign planner	Editor+
PUT	/planners/{id}	Update planner configuration	Editor+
DELETE	/planners/{id}	Delete a planner	Editor+

Topic Clusters

Method	Path	Description	Role
GET	/planners/{id}/clusters	List topic clusters for a planner	Editor+
POST	/planners/{id}/clusters	Create a topic cluster	Editor+
PUT	/clusters/{id}	Update a topic cluster	Editor+
DELETE	/clusters/{id}	Delete a topic cluster	Editor+

Content Queue

Method	Path	Description	Role
GET	/queue	List posts in the content queue	Editor+
POST	/queue/{id}/approve	Approve a queued post for publishing	Editor+
POST	/queue/{id}/reject	Reject a queued post	Editor+

Pipeline Runs

Method	Path	Description	Role
GET	/pipeline/runs	List pipeline execution history	Editor+
GET	/pipeline/runs/{id}	Get detailed status of a pipeline run	Editor+

Scout Bot

Method	Path	Description	Role
GET	/scout/config	Get Scout Bot configuration	Editor+
PUT	/scout/config	Update Scout Bot configuration	Editor+
POST	/scout/hunt	Run opportunity hunting (Rising, Trending, Gap, Adjacent strategies)	Editor+
POST	/scout/hunt-and-analyze	Hunt + analyze top opportunities in one call	Editor+
POST	/scout/trigger	Trigger a full Scout Bot cycle (hunt, analyze, recommend)	Editor+
GET	/scout/status	Get current Scout Bot cycle status	Editor+
GET	/scout/recommendations	List Scout Bot recommendations	Editor+
POST	/scout/recommendations/{id}/accept	Accept a recommendation	Editor+
POST	/scout/recommendations/{id}/dismiss	Dismiss a recommendation	Editor+

Content Strategies

Method	Path	Description	Role
GET	/strategies	List content strategies for a planner	Editor+
POST	/strategies/generate	Generate AI content strategies for a keyword plan	Editor+
POST	/strategies/{id}/approve	Approve a generated strategy	Editor+
POST	/strategies/approve-all	Approve all strategies for a planner	Editor+
POST	/strategies/{id}/regenerate	Regenerate a strategy with previous context	Editor+

Keyword Registry

Method	Path	Description	Role
GET	/registry	List all keywords in the registry	Editor+
GET	/registry/search	Search the keyword registry	Editor+

Cannibalization Detection

Method	Path	Description	Role
POST	/cannibalization/detect	Detect keyword cannibalization across posts	Editor+

Content Freshness

Method	Path	Description	Role
GET	/freshness	List content freshness scores	Editor+
GET	/freshness/{id}/score	Get freshness score for a specific post	Editor+