API & MCP documentation

Build a monthly client report without opening the dashboard. Then let your brand-trained assistant polish an article — the same way you would in the editor.

This is on Enterprise and agency plans. A key can only see the websites on that account.

What you can do

  1. List the websites on your account.
  2. List articles published in a date range, with the target search term and word count.
  3. List backlinks you acquired, including industry vs local.
  4. Pull a period summary for a monthly report.
  5. Edit an article title and body, or replace the featured image.

Authentication

Create a key at the bottom of Connect Site. Send it on every request:

Authorization: Bearer YOUR_API_KEY
X-API-Key: YOUR_API_KEY

Limit: 60 requests per minute per key. Article edits: 200 per day per key.

Log in to create a key.

Read endpoints

  • GET /api/v1/sites — your websites
  • GET /api/v1/sites/{id}/articles?from=&to=&status= — id, title, url, status, published_at, target keyword, word count, featured image
  • GET /api/v1/articles/{id} — full HTML body. Protected links include data-autoseo-protected.
  • GET /api/v1/sites/{id}/backlinks?from=&to= — date acquired, source domain, source url, target url, anchor text, anchor type, category (industry / local)
  • GET /api/v1/sites/{id}/stats?period= — articles and backlinks for this_month, last_month, last_30_days, or YYYY-MM

Lists are paginated. Use page and per_page (max 100).

Write endpoints

Writes only change articles on your own sites. Settings, search terms, and backlinks stay off limits.

  • PUT /api/v1/articles/{id} — JSON: title, body (HTML), optional reason. Same sanitising as the editor. No scripts or raw iframes.
  • POST /api/v1/articles/{id}/featured-image — multipart image, or JSON { "url": "https://..." }.
Do not remove or rewrite inserted backlink anchors or internal links. Those blocks are marked in the HTML. An edit that strips them is rejected so the backlink network stays intact.

MCP for agents

If you do not want to write code, run the MCP server. It maps tools to the same endpoints. Same key, same limits, same learning log.

Local

npx -y @autoseo/mcp
AUTOSEO_API_KEY=YOUR_API_KEY
AUTOSEO_API_URL=https://getautoseo.com

Hosted

https://mcp.getautoseo.com
Authorization: Bearer YOUR_API_KEY

Tools: list_sites, list_articles, get_article, list_backlinks, get_stats, update_article, replace_featured_image.

Copy-paste configs for Claude Desktop and Cursor are at the bottom of Connect Site.

Learning log

Every API and MCP call is stored. Every article change is stored as a revision (API, MCP, editor, or rewrite). You can open the activity log and restore an earlier version from the article page.

OpenAPI

Machine-readable spec:

https://blog.olathebidhub.com/api/v1/openapi.json