API

Scoring API

Status: Coming soon. The public API is on the roadmap and not yet available. Want it sooner? Request early access.

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.