# Moz API — Domain Authority, spam score, top pages and linking domains, keyword volume and difficulty, organic competitors, local listing scan, Top 500, MozCast, Google updates

> Moz's free domain report for any domain: Domain Authority (1-100), linking root domains and ranking keywords (as Moz prints them, e.g. 460.6k, plus the expanded number), spam score, the home page's Page Authority, the top pages by Page Authority and the top linking domains by Domain Authority (the page shows up to 7 of each), and 60 days of discovered and lost linking domains. A subdomain gets the root domain's numbers. A domain Moz has no links for returns DA 1 with `has_link_data: false`.
> ReefAPI engine `moz` · 9 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/moz/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/moz/v1/domain_report — 3 credits
Moz's free domain report for any domain: Domain Authority (1-100), linking root domains and ranking keywords (as Moz prints them, e.g. 460.6k, plus the expanded number), spam score, the home page's Page Authority, the top pages by Page Authority and the top linking domains by Domain Authority (the page shows up to 7 of each), and 60 days of discovered and lost linking domains. A subdomain gets the root domain's numbers. A domain Moz has no links for returns DA 1 with `has_link_data: false`.

**Parameters:**
- `domain` (string, required) — A domain (hubspot.com), any link on it, or a moz.com/domain-analysis/<domain> link. IDN names are accepted (münchen.de).

**Returns:** domain, requested_domain, domain_url, report_url, domain_authority, linking_root_domains, linking_root_domains_display, linking_root_domains_is_rounded, ranking_keywords, ranking_keywords_display, ranking_keywords_is_rounded, spam_score_percent, spam_score_display, home_page_authority, has_link_data, top_pages[]{rank, page, url, page_authority}, top_pages_count, top_pages_note, top_linking_domains[]{rank, domain, url, domain_authority}, top_linking_domains_count, top_linking_domains_note, link_history{period_start, period_end, day_count, total_discovered, total_lost, net_change, days[]{date, discovered, lost, net_change}}

**Example request body:**
```json
{
  "domain": "hubspot.com"
}
```

### POST https://api.reefapi.com/moz/v1/keyword_metrics — 3 credits
Moz Keyword Explorer for one keyword in one Google market: monthly search volume, keyword difficulty (0-100), organic CTR (% of clicks that go to organic results), the top 5 keyword suggestions with their volumes and how many suggestions Moz has in total. 27 locales.

**Parameters:**
- `keyword` (string, required) — The search term (up to 256 characters).
- `locale` (enum, optional, default "en-US") — Google market (language-country). [one of: en-US, en-GB, en-CA, nl-NL, de-DE, en-AU, fr-FR, es-ES, no-NO, el-GR, en-IE, sv-SE, ro-RO, de-CH, it-IT, da-DK, pl-PL, nl-BE, es-AR, es-MX, de-AT, en-NZ, hr-HR, ja-JP, uk-UA, fi-FI, en-IN]

**Returns:** keyword, locale, device, search_engine, vicinity, strategy, monthly_volume, difficulty, organic_ctr_percent, suggestions[]{keyword, suggestion_volume}, suggestions_returned, suggestions_total

**Example request body:**
```json
{
  "keyword": "running shoes"
}
```

### POST https://api.reefapi.com/moz/v1/competitive_research — 3 credits
Moz Competitive Research for a domain: its Domain Authority, Page Authority and exact number of ranking keywords split by position (1-3, 4-10, 11-20, 21+), the same for its top organic competitors (Moz returns 3), and the keywords where Moz sees the biggest traffic opportunity (5, with estimated traffic lift). Scores the root domain. For a domain Moz has not prepared recently the first call can fail with UPSTREAM_TIMEOUT while Moz computes it; the same call succeeds once Moz has it (failed calls are not charged).

**Parameters:**
- `domain` (string, required) — A domain (hubspot.com), any link on it, or a moz.com/domain-analysis/<domain> link. IDN names are accepted (münchen.de).

**Returns:** domain, requested_domain, domain_authority, page_authority, ranking_keywords, ranking_keywords_by_position{top_3, pos_4_to_10, pos_11_to_20, pos_21_plus}, competitors[]{position, domain, url, domain_authority, page_authority, ranking_keywords, ranking_keywords_by_position}, competitor_count, rows[] (target first), keyword_opportunities[]{keyword, traffic_lift}, keyword_opportunity_count

**Example request body:**
```json
{
  "domain": "hubspot.com"
}
```

### POST https://api.reefapi.com/moz/v1/local_scan — 3 credits
Moz Local listing scan for one business (US, Canada, UK): checks 29 networks (Google, Google Maps, Bing, Apple Maps, Facebook, Yelp, Yahoo Local, TripAdvisor, Nextdoor, Yellow Pages, Foursquare-era directories…) and returns, per network, whether the business is listed, the listed name / address / phone / website / rating / review count, and which fields match or differ from what you sent, plus totals by listing status. A scan takes about a minute: this call waits up to `wait_seconds` (default 90) and returns what is done with `scan_id`; read the rest with `local_scan_result`. A business Moz scanned recently comes back finished at once.

**Parameters:**
- `business_name` (string, required) — Business name as customers know it.
- `street_address` (string, required) — Street address.
- `city` (string, required) — City.
- `state` (string, required) — State / province code (US: WA, CA: ON); for the UK the county or city (London). Moz rejects an empty value.
- `postal_code` (string, required) — ZIP / postal code.
- `phone` (string, optional) — Phone number (optional).
- `business_type` (enum, optional, default "general_local") — Moz Local business type. [one of: general_local, healthcare, restaurant_hospitality, retail_storefront, service_area_business, professional_services, automotive, personal_care_wellness]
- `wait_seconds` (integer, optional, default 90) — How long this call waits for the scan (0 = start and return the scan_id at once).

**Returns:** scan_id, status, is_complete, percent_complete, networks_completed, networks_total, completed_sources[], requested_networks[], summary{average_listing_rating, total_listing_reviews, correct_listings, listings_with_incorrect_data, listings_by_status, inconsistent_fields, …}, listings[]{source, network, status, status_detail, url, business_name, address, street_address, city, state, postal_code, phone, website, business_hours, rating, review_count, photo_count, video_count, field_match{…}}, listing_count, created_at, updated_at, report_link

**Example request body:**
```json
{
  "business_name": "Pike Place Chowder",
  "street_address": "1530 Post Alley",
  "city": "Seattle",
  "state": "WA",
  "postal_code": "98101"
}
```

### POST https://api.reefapi.com/moz/v1/local_scan_result — 1 credit
The current state of a Moz Local listing scan started with `local_scan`: progress, totals and every network checked so far.

**Parameters:**
- `scan_id` (string, required) — `scan_id` from local_scan.

**Returns:** same shape as local_scan

**Example request body:**
```json
{
  "scan_id": "f8a3b900-f89d-4502-9a05-bdfaa97e4684"
}
```

### POST https://api.reefapi.com/moz/v1/top_domains — 1 credit
Moz Top 500: the 500 most-linked domains on the web with their exact linking root domain count and Domain Authority, in Moz's order.

**Parameters:**
- `query` (string, optional) — Keep only rows whose domain contains this text (case-insensitive).
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 100) — Rows per page (1-500).

**Returns:** domains[]{rank, domain, url, linking_root_domains, domain_authority} + total + page + page_size + total_pages + has_more

**Example request body:**
```json
{
  "page_size": 100
}
```

### POST https://api.reefapi.com/moz/v1/top_brands — 3 credits
Moz Top 500 US brands by Brand Authority, with each brand's ranking keyword count and the date Moz last updated the list.

**Parameters:**
- `query` (string, optional) — Keep only rows whose domain contains this text (case-insensitive).
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 100) — Rows per page (1-500).

**Returns:** brands[]{rank, domain, url, brand_authority, ranking_keywords} + list_updated + total + page + page_size + total_pages + has_more

**Example request body:**
```json
{
  "page_size": 100
}
```

### POST https://api.reefapi.com/moz/v1/algorithm_updates — 3 credits
Moz's history of Google algorithm updates since 2000, newest first: name, date, confirmed or not, Moz's write-up and the source articles; filter by year, status and text; plus the hottest MozCast days Moz charts on the same page.

**Parameters:**
- `year` (integer, optional) — Only updates of this year (the page lists 2000-2026).
- `status` (enum, optional) — Confirmed by Google or not. [one of: confirmed, unconfirmed]
- `query` (string, optional) — Text in the update name or Moz's description.
- `page` (integer, optional, default 1) — Page number (1-based).
- `page_size` (integer, optional, default 25) — Rows per page (1-300).

**Returns:** updates[]{name, date, date_text, year, status, is_confirmed, description, sources[]{title, publisher, publisher_code, url}} + most_volatile_days[]{name, date, date_text, temperature_f} + total + page + page_size + total_pages + has_more + years_available[]

**Example request body:**
```json
{
  "year": 2026
}
```

### POST https://api.reefapi.com/moz/v1/mozcast — 2 credits
MozCast, Moz's daily Google weather report: the 'temperature' of ranking change over 10,000 keywords (about 70°F is a quiet day), domain diversity, big-10 share, exact/partial-match domain share, and the daily prevalence of 7 SERP features (local packs, featured snippets, knowledge graph, videos, HTTPS, review stars, sitelinks), up to 90 days.

**Parameters:**
- `days` (integer, optional, default 30) — How many days back (newest first).
- `feature` (enum, optional) — Only this SERP feature's series. [one of: local-packs, featured-snippets, knowledge-graph, videos, https-results, reviews, sitelinks]

**Returns:** today{date, temperature_f, weather} + summary{period_start, period_end, average_temperature_f, min_temperature_f, max_temperature_f, hottest_date} + days[]{date, temperature_f, weather, day_of_week, average_page_one_results, domain_diversity_percent, big_10_share_percent, exact_match_domain_share_percent, partial_match_domain_share_percent} + serp_features[]{slug, name, moz_token, current_prevalence_percent, history[]{date, prevalence_percent}} + notice

**Example request body:**
```json
{
  "days": 30
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=moz
- Human docs page: https://reefapi.com/docs/moz
- Overview page: https://reefapi.com/moz-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
