mocop
Browse · Docs · Guide · Analyze

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.
About · Contact · Privacy