SEOmatic API
API by SEOmatic · rest
SEOmatic public API v1. Authenticate with a workspace API key: Authorization: Bearer smk_live_.... GET /tools lists the full scope-filtered capability surface (identical to the MCP server); POST /tools/{name} invokes any of them. Keys carry scopes: free keys can read and ask; acting requires an agents:act key, and acting over REST requires the Infrastructure plan. Rate limits are per key; responses carry X-RateLimit-* headers and 429s carry Retry-After. Workspaces metered for free questions also get X-SEOmatic-Questions-Remaining (free questions left this month) on /tools/{name} and /ask answers, limit refusals included. One question is one user turn: market-data calls from the same key share one question while each comes within 90 seconds of the previous one, up to 5 lookups; the 6th starts a new question. Search Console, site and stored reads never use a question. Pay as you go: a workspace without a plan can buy prepaid credits in US dollars (from $20, never expire, only…
Endpoint: https://app.seomatic.ai/api/v1
Verification: observed. Source: crawl.
Capabilities (43)
- The latest completed AI-answers scan of the workspace's own site summarized.
- Fixes waiting for a person to approve newest-scored first (at most 20 shown).
- List purchased articles (bodies excluded) and the spendable prepaid balance.
- Generate one SEO article from a topic (consumes 1 prepaid unit pay-as-you-go:…
- Get a Stripe payment link to top up a prepaid balance: articles by default ($9…
- Machine Payments Protocol (MPP) payment link for article units. POST with no…
- Pay for prepaid article units with a Stripe Shared Payment Token (agentic…
- One article. When status=ready the body carries BOTH formats: markdown (source…
- Edit a delivered article: {title? markdown?}. html is re-rendered server-side…
- Cancel a queued or generating article and get its prepaid unit back.…
- Ask one natural-language question answered with this key's own tool roster.
- The result of an async question (POST /ask with async: true).
- Store the workspace's canonical business facts as AI ground truth.
- Tell the SEOmatic team that one of its tools answered wrong failed or nearly…
- Pages that LOST clicks: the recent window vs the adjacent window before it.
- The queries Search Console attributes to ONE page.
- Top pages from the workspace's Google Search Console property.
- Top search queries from the workspace's Google Search Console property.
- Register the IndexNow key the site hosts (the Instant indexing module of the…
- Disable the IndexNow key the plugin registered.
- Store the site's internal-linking health reading.
- Introspect the calling key: workspace environment scopes and the plan…
- Revoke the calling API key itself (for example when an integration or browser…
- Score one public page for AI/LLM answerability.
- Per-page AI engagement: answer-crawler fetches and AI-referred visits.