# Moz API (slim)

> Moz API is a hosted JSON-RPC 2.0 service for SEO data from Moz's link and keyword indexes. It returns Domain Authority, backlinks, keyword metrics, ranking keywords and search results, with a beta MCP server for AI clients.

- Full: https://www.anchorterminal.com/tools/moz-api.md (~7,900 tokens) · this version ~2,030 tokens · JSON https://www.anchorterminal.com/tools/moz-api.json · canonical https://www.anchorterminal.com/tools/moz-api
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-08

**E · 45.3/100 · rank #571 of 629 · #6 in SEO & search visibility · not agent-ready · confidence medium**


Assessment: The JSON-RPC API documents every error code, its rate limits and the row cost of each method, and failed validation uses no quota. No working status page, SLA, machine-readable spec or official SDK was found. Tokens carry no scopes, and the free plan needs a credit card.

## Facts

- Kind: HTTP API · vendor: SEOmoz, Inc. · category: SEO & search visibility · legal entity: SEOmoz, Inc. · provenance 79/100
- Endpoint: `https://api.moz.com/jsonrpc` (HTTP, Streamable HTTP)
- Auth: API key · pricing: Freemium · x402: no · licence: Proprietary service under the Moz API General Conditions (effective 12 August 2026 for new subscribers). Displaying Moz data to others requires attribution under the API legal page
- Probe metrics: not measured yet (probes haven't run)
- API: JSON-RPC 2.0 over POST at https://api.moz.com/jsonrpc, single and batch requests, gzip in both directions, request bodies up to 100 KB after decompression
- Methods: 73 documented. 33 `data` methods (site metrics, Brand Authority, links, linking domains, anchor text, link intersect, link status, final redirect, top pages, competitors, ranking keywords, keyword metrics, search intent, related keywords, SERP fetch and generate, global top domains and pages), 35 `local` methods for Moz Local, plus quota, index, async and test calls
- MCP server: Beta since 14 August 2026. https://api.moz.com/mcp/v1/data (needs a Moz API subscription) and https://api.moz.com/mcp/v1/local (needs Moz Local). OAuth or a Bearer token. Account owners only. Tool list not readable without an account
- Credentials: Up to five deletable tokens per account, sent as `x-moz-token`. No scopes found. MCP OAuth metadata lists authorisation code, PKCE S256, dynamic client registration and the scope `mcp`
- Rate limits: Free plan one request every ten seconds. Edge limits of 2,000 requests in 60 seconds, 20 client errors in 60 seconds, and a 30-minute block after ten 401 or 403 responses in five minutes. `data.keyword.serp.generate` shares 2,000 requests an hour across all callers
- Errors: Thirteen documented codes from -32700 to -32650 with HTTP status, `data.issue`, `data.key` and `data.explanation`. Per-method 429 (-32658) carries `Retry-After`, edge 429 (-32650) does not
- Quota: Counted in rows. `data.site.metrics.fetch` costs one row a call, list methods one row per result, `data.keyword.serp.generate` up to 21 rows. `quota.lookup`, `metadata.index.fetch` and the test methods are free
- Paging: `offset.limit` (1 to 50 on link lists, default 25) and an opaque `offset.token` returned with each page
- Async: Some methods return an `async_call` with `pending`, `processing` or `complete` status and a `ttl` in seconds, polled with `async.call.lookup`
- SERP coverage: `engine` is google, bing or yahoo, `device` is desktop, mobile_android or mobile_ios, and `locale` is a Google hl-gl pair such as en-US. Ranking keywords cover the top 50 Google results
- Versioning: Not versioned. The docs expect no breaking changes outside beta methods. Some link and site methods are still documented only in the legacy docs at https://moz.com/help/links-api
- Terms: API General Conditions effective 12 August 2026 (new subscribers) and 11 September 2026 (existing). Availability on commercially reasonable efforts, fees non-refundable, no AI training on the data, attribution required for external display
- Status: No working public status page found. moz.statuspage.io redirects to a page saying Moz Status is inactive
- Prices: Free plan free per month (plan); Starter Medium $20 per month (plan); Starter Large $75 per month (plan); Growth Small $125 per month (plan); Growth Medium $250 per month (plan); Growth Large $500 per month (plan); Overage row, Starter Large $0.005 per record; Overage row, Growth Small $0.0025 per record; Overage row, Growth Medium $0.002 per record; Overage row, Growth Large $0.001 per record

- Scores: Reliability 42, Performance pending, Schema & documentation 50, Agent ergonomics 74, Security & auth 38, Payments & pricing 20, Task success pending, Maintenance & community 28, Transparency & trust 59 · total over the 7 assessed categories
- Why: Reliability, Graded on the public JSON-RPC API with the hosted lines. · Schema & documentation, No downloadable OpenAPI or OpenRPC file was found, and api.moz.com/openrpc.json and /openapi.json return 404. Each method page is generated… · Agent ergonomics, List methods take `limit` (1 to 50 on link lists) and separate methods return a single keyword metric, but no field selection was found, and… · Security & auth, Plain revocable tokens, up to five per account, sent in the `x-moz-token` header and never in a URL. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, The newest dated Moz API entry in the product updates archive is the MCP server beta of 14 August 2026, 55 days before the check (20). · Transparency & trust, Editorial half only.
- Sources: 19, open questions: 9, both in the full twin
- Capabilities: seo.keywords, seo.backlinks, seo.serp, seo.rankings
- JSON: https://www.anchorterminal.com/api/v1/tools/moz-api.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/moz-api.svg` or a link to https://www.anchorterminal.com/tools/moz-api from a page on moz.com or one of its subdomains, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Send a request `id` of at least 24 characters (letters, numbers and hyphens). A UUID works. Shorter ids are rejected with -32654.
2. Stop on a 401. Ten 401 or 403 responses in five minutes block the caller for 30 minutes.
3. On 429 with code -32658 wait the `Retry-After` seconds. On code -32650 no wait time is given, so back off exponentially.
4. Call `quota.lookup` (free) before large pulls. List methods charge one row per result, and `limit` is capped at 50 on link lists.
5. Poll `async.call.lookup` for `data.keyword.serp.generate`, and collect the result within 20 seconds of first seeing it complete.

## Connect

```bash
curl -X POST https://api.moz.com/jsonrpc -H "x-moz-token: $MOZ_TOKEN" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":"01a0458f-a14f-7254-aa11-7c6cb734e3f2","method":"quota.lookup","params":{"data":{"path":"api.limits.data.rows"}}}'
```

```bash
claude mcp add moz-mcp-v1-data https://api.moz.com/mcp/v1/data --transport http --header "Authorization: Bearer $YOUR_MOZ_TOKEN" --scope user
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/moz-api

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| DataForSEO | B | 64.9 | seo.keywords, seo.backlinks, seo.serp, seo.rankings | https://www.anchorterminal.com/tools/dataforseo.min.md |
| Manifold | C | 56.2 | seo.keywords, seo.backlinks, seo.serp, seo.rankings | https://www.anchorterminal.com/tools/manifold-mcp.min.md |
| Semrush API + MCP | D | 53.1 | seo.keywords, seo.backlinks, seo.rankings, seo.serp | https://www.anchorterminal.com/tools/semrush.min.md |
| Ahrefs | D | 49.8 | seo.keywords, seo.backlinks, seo.serp, seo.rankings | https://www.anchorterminal.com/tools/ahrefs.min.md |
| Similarweb | D | 46 | seo.keywords, seo.serp, seo.rankings | https://www.anchorterminal.com/tools/similarweb.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)