SEO API

A structured SEO API for Actions, execution, and validation.

QueryAction exposes search-growth evidence as JSON so internal tools, agents, and CLIs can retrieve Actions without scraping dashboards.

REST APICLIPython
GET /api/actions/:id
{
  "id": "1-low-ctr-best-ai-photo-restoration",
  "query": "seo api",
  "page": "https://recolorlife.com/",
  "impressions": 310,
  "clicks": 0,
  "ctr": 0,
  "position": 13.8,
  "suggestedAction": {
    "type": "rewrite_snippet",
    "validation": ["title", "meta", "h1"]
  }
}
GrowthAction queue
  • recolorlife.comlow_ctr / striking_distance / content_gapDeterministic rule type
  • bestdatingphotos.comimpressions, clicks, CTR, positionFrom latest GSC sync
  • bestdatingphotos.comsuggestedAction + validation checklistReady for Markdown export
View all Actions ->
Google Search Console

Queries, pages, performance

Web crawl

On-page and technical checks

SERP API

Competitor signals

Markdown export

Docs and reports

Why it matters

SEO API without another passive report.

Use API output as the contract

The browser UI and agent workflows rely on the same Action fields.

Build CLI flows without dashboard scraping

Agents can retrieve the selected Action and turn it into code, content, or implementation changes.

Keep validation attached

Future crawler and measurement APIs can extend the same Action record instead of creating disconnected reports.

Workflow

From evidence to action.

  1. 01

    Authenticate to QueryAction.

  2. 02

    List sites and Actions.

  3. 03

    Fetch Action detail by id.

  4. 04

    Post future validation and measurement results.