API

Scoring API

Status: Coming soon. The REST scoring API is on the roadmap and not yet available. Programmatic access works today through the MCP server, authenticated with an API key on every plan. Want the REST API sooner? Request early access.

What is the planned shape?

When released, the API will expose the same canonical scoring model the app uses today: authenticate with a Bearer API key, POST a draft and target keyword, and receive Content Score, GEO Score, and a prioritized action list.

# Planned request
POST https://seo-ai-regent.com/api/v1/score/content
Authorization: Bearer <your-api-key>
Content-Type: application/json

{
  "keyword": "content optimization strategies",
  "content": "<your draft as plain text or TipTap JSON>"
}

# Planned response
{
  "contentScore": { "overall": 84, "signals": { "termFrequency": 88, "entityCoverage": 80 } },
  "geoScore":     { "overall": 81, "signals": { "entityAuthority": 76, "factualDensity": 84 } },
  "topActions":   [ { "area": "Content", "title": "Add internal navigation paths", "lift": 6.5 } ]
}

This request and response are illustrative of the planned design and may change before release.