API Overview
MisarSEO REST API reference — base URL, authentication, and endpoint index.
Base URL
https://api.misar.io/seo
Authentication
MisarSEO v1 is workspace-scoped and uses same-TLD cookie SSO via id.misar.io. First-party
requests are authenticated by the SSO session; the resolved user_id scopes every project,
audit, and report to the calling workspace.
Internal preview
Public API keys for api.misar.io/seo/* are not yet issued. The endpoints below describe the
v1 surface served by the MisarSEO app behind SSO.
Endpoints
| Endpoint | Methods | Description |
|---|---|---|
/v1/projects | GET POST | List or create tracked projects (a domain + locale set) |
/v1/projects/:id | GET PATCH DELETE | Read, update, or delete a project |
/v1/keywords | GET POST | List tracked keywords or add keywords to a project |
/v1/rank-tracker | GET | Keyword position history and SERP-feature snapshots |
/v1/audit | POST | Start a site audit crawl |
/v1/audit/:id | GET | Audit run status and graded issues |
/v1/keywords/research | POST | Keyword ideas, related terms, and volume estimates |
/v1/ai-radar/mentions | POST | Sample AI prompts where the target is surfaced/cited |
/v1/ai-radar/metrics | POST | Aggregated AI-search visibility metrics for a target |
/v1/ai-radar/top-pages | POST | Pages most often cited alongside the target |
/v1/ai-radar/compare | POST | Compare AI-search visibility across 2–10 entities |
AI-Search Radar data
AI-Search Radar estimates visibility using the Misar assisters.dev gateway, grounded in the
model's own knowledge. For entities the model does not recognise it returns empty/zero rather
than fabricated metrics.
Error Format
All errors return:
{ "error": "Human-readable message" }