NewEvoras for AI agents
Evoras
Start now
evoras.app/docs/api

REST API overview

The Evoras REST API — programmatic access to keywords, articles, Search Console data, and generation, built for scripts and autonomous AI agents alike.

Evoras isn't just user-friendly — it's agent-friendly. Everything your dashboard can do with keywords, articles, and Search Console data is available over a plain REST API, and as an MCP server your AI agents can plug straight into.

  • Base URL: https://evoras.app/api/v1
  • Format: JSON in, JSON out (snake_case fields)
  • Auth: API key as a bearer token
  • MCP endpoint: https://evoras.app/api/mcp

Authentication

Create a key in Settings → API keys (any Evoras account). Keys look like ev_live_… and are shown once at creation — store them like passwords.

Pass the key on every request:

curl https://evoras.app/api/v1/me \ -H "Authorization: Bearer ev_live_your_key_here"

A key can access every site its owner can access — call GET /v1/me or GET /v1/sites first to get site IDs for the per-site endpoints.

Rate limits

WindowLimit
Per minute120 requests per key
Per day10,000 requests per key

Every response carries X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix seconds) for the per-minute window. Exceeding a limit returns 429 with a Retry-After header. Endpoints that run or enqueue AI work (suggest, generate) have tighter per-hour caps.

Errors

Errors are JSON with a machine-readable code:

{
  "error": {
    "code": "quota_exceeded",
    "message": "This site has used all 30 articles for the current period (resets 2026-08-01T00:00:00.000Z)."
  }
}
StatusMeaning
400Malformed request — error.details lists the failing fields
401Missing or invalid API key
404Resource not found
429Rate limit exceeded — check Retry-After header
5xxServer error — retry after a delay or contact support

MCP server

Evoras also offers an MCP (Model Context Protocol) server at https://evoras.app/api/mcp that lets AI agents like Claude and Copilot interact with your Evoras data directly. The MCP server exposes tools for reading articles, managing keywords, and triggering publishing — all through natural language from within your AI coding assistant. See the MCP server docs for setup instructions.

← FAQSites →