canonical: https://jentic.com/apis/moz.com/moz

# Moz Links API

Jentic publishes the only available OpenAPI specification for Moz Links API, keeping it validated and agent-ready. The Moz Links API exposes Moz's link intelligence dataset for any URL, subdomain, or root domain on the web, returning Domain Authority, Page Authority, Spam Score, link counts, anchor text distribution, and top page rankings. SEO teams and agents use it to audit backlink profiles, benchmark competitor authority, and surface high-value linking domains. The API exposes eight POST endpoints for batched lookups against url_metrics, anchor_text, links, linking_root_domains, and top_pages resources.

## For AI agents

Look up Moz Domain Authority, Page Authority, Spam Score, and backlink data for any URL or domain to power SEO audits and competitor research.

## Scope

Does not handle on-page SEO audits, keyword rank tracking, or content analysis - use for backlink and domain authority lookups only.

## Capabilities

- Retrieve Domain Authority, Page Authority, and Spam Score for batches of up to 50 targets via POST /url_metrics
- Pull anchor text distributions for inbound links to any URL or root domain via POST /anchor_text
- Enumerate inbound links with source page, target, and anchor metadata via POST /links
- List linking root domains pointing to a target with count and authority metrics via POST /linking_root_domains
- Surface the top-ranking pages on a subdomain or root domain via POST /top_pages
- Query global top pages and global top root domains for industry-wide authority benchmarking
- Track API usage and remaining quota against the account plan via POST /usage_data

## Use cases

### Backlink Audit and Toxic Link Detection

Run a full audit of inbound links to a domain by calling /links and /linking_root_domains, then enrich each referring domain with Spam Score and Domain Authority via /url_metrics. The output identifies low-quality referrers worth disavowing and high-value partners worth nurturing. A typical 5,000-link audit completes in minutes when batched 50 targets at a time against the Moz Links API.

Example prompt: Pull all linking root domains for example.com via POST /linking_root_domains, batch them through POST /url_metrics, and return the 20 referrers with Spam Score above 70.

### Competitor SEO Benchmarking

Compare Domain Authority, Page Authority, and top-performing pages across a set of competitor domains. Posting up to 50 targets at a time to /url_metrics and /top_pages yields a structured benchmark dataset. Marketing teams use this to size the gap between their site and the leading domain in a category before scoping an SEO programme.

Example prompt: Call POST /url_metrics with a list of 10 competitor domains and POST /top_pages for each, then rank them by Domain Authority and surface the top three pages per competitor.

### Anchor Text Profile Analysis

Inspect the distribution of anchor text driving links to a target URL using /anchor_text. The endpoint returns each anchor phrase with its link count and source distribution, exposing whether a backlink profile is dominated by branded, exact-match, or generic anchors. This is the standard input for over-optimisation risk assessment before a link-building push.

Example prompt: Call POST /anchor_text for the target URL and return the top 25 anchor phrases bucketed as branded, exact-match, partial-match, or generic.

### Agent-Driven Outreach List Generation

An AI agent identifies high-authority outreach targets by querying global top root domains via POST /global_top_root_domains, filtering for niche-relevant candidates, then validating each through POST /url_metrics. Through Jentic the agent loads the schema, executes the call, and hands a scored prospect list back to the marketer in one workflow.

Example prompt: Search Jentic for 'look up domain authority', load the Moz url_metrics schema, and score 200 candidate outreach domains by Domain Authority and Spam Score.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /url_metrics | Fetch Domain Authority, Page Authority, and Spam Score for a batch of URLs |
| POST | /anchor_text | Return anchor text distribution for a target URL |
| POST | /links | List inbound links with source and anchor detail |
| POST | /linking_root_domains | List unique referring root domains for a target |
| POST | /top_pages | Return top-ranking pages on a subdomain or root domain |
| POST | /usage_data | Report remaining API quota for the account |

## Key resources

- **URL Metrics** — Domain Authority, Page Authority, Spam Score, and link counts for any URL
- **Links** — Detailed inbound link records with source, target, and anchor metadata
- **Linking Root Domains** — Unique referring domains for a target with authority and link counts
- **Anchor Text** — Anchor phrase distribution across inbound links
- **Top Pages** — Highest-authority pages on a subdomain, root domain, or globally
- **Usage Data** — Remaining API quota and consumption reporting

## Why Jentic

- **Setup:** Wiring the Moz Links API by hand means building its basic-auth header from your access ID and secret, targeting the seomoz host, and staying inside its row quota across link and metric calls. Through Jentic you install once, import the Moz Links API from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** Moz carries its targets in the request body rather than the URL path, so limit the agent to the operations it needs, such as looking up URL metrics or backlinks. You choose the operations it may call, so it stays within the lookups you allow.
- **Credential handling:** Your Moz access ID and secret key are stored once, encrypted, by your own Jentic One instance and used to build the Basic auth header at execution time. The raw pair never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'look up domain authority' or 'find a page's backlinks', and Jentic returns the matching Moz operation with its input schema, so the agent calls the right endpoint without reading Moz's row-quota docs.

## Related APIs

- **Ahrefs API** — Ahrefs offers a competing link intelligence dataset with its own authority and backlink scoring
- **Semrush API** — Semrush exposes backlink, keyword, and traffic estimation data for competitive SEO research
- **Google Search Console API** — Search Console reports Google's own view of impressions, clicks, and indexed pages

## FAQ

### Why is there no official OpenAPI spec for Moz Links API?

Moz does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Moz Links API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Moz Links API use?

The Moz Links API uses HTTP Basic authentication. You send your Moz API access ID as the username and the secret key as the password on every request. Through Jentic those credentials live in the encrypted vault and never enter the agent's prompt context.

### Can I look up Domain Authority for many URLs in a single call?

Yes. POST /url_metrics accepts a batch of targets in one request, so you can score up to 50 URLs per call instead of issuing one request per target. Batch every audit to stay inside quota.

### What are the rate limits for the Moz Links API?

Moz enforces row-quota limits tied to your subscription tier rather than a per-second rate cap, and POST /usage_data returns your remaining rows for the current period. Check the response headers and the usage_data endpoint to avoid quota exhaustion mid-job.

### How do I run an anchor text audit through Jentic?

Search Jentic with the query 'analyze backlink anchor text', load the Moz anchor_text schema, then execute against POST /anchor_text with the target URL. The agent receives the parsed anchor distribution without ever holding the raw API secret.

### Is the Moz Links API free?

No. The Moz Links API is a paid product gated by row quotas tied to Moz Pro and standalone API plans. A limited free tier exists for evaluation but production use requires a paid subscription.

### Can I limit what my agent is allowed to do with the Moz Links API?

Yes. Because you run Jentic One yourself, your own rules decide which Moz operations and credentials the agent may use. The Moz Links API carries its targets in the request body rather than the URL path, so you scope access at the operation level: you can allow read-only lookups like POST /url_metrics for Domain Authority and Spam Score while withholding /links, /linking_root_domains, /anchor_text, or /top_pages if the task does not need them. The agent can only call the operations you permit, and it never sees the raw access ID and secret key behind them.