Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Moz API page →
Search & SEO

Moz API & Scraper

The Moz API returns what Moz's free SEO tools show as JSON: Domain Authority, spam score, top pages and linking domains for any domain, keyword volume and difficulty in 27 Google markets, organic competitors and a 29-network local listing scan.

9 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

It reads them logged out. `domain_report` takes any domain and returns its Domain Authority (1 to 100), linking root domains and ranking keywords as Moz prints them (for example 460.6k) together with the expanded number, the spam score, the home page's Page Authority, the 7 top pages by Page Authority, the 7 top linking domains by Domain Authority, and up to 61 days of discovered and lost linking domains. `keyword_metrics` returns Moz's monthly search volume, keyword difficulty and organic click-through rate for a keyword in one of 27 Google markets, with 5 suggestions and how many suggestions Moz has in total. `competitive_research` returns a domain's exact ranking-keyword count split by position (1-3, 4-10, 11-20, 21+), its top 3 organic competitors with the same numbers, and 5 keyword opportunities with estimated traffic lift. `local_scan` checks one business on 29 maps, directories and assistants (Google, Bing, Apple Maps, Facebook, Yelp, Yahoo Local, TripAdvisor, Yellow Pages and others) and returns, per network, whether it is listed, the listed name, address, phone, website, rating and review count, and which fields differ from what you sent. `top_domains`, `top_brands`, `mozcast` and `algorithm_updates` return Moz's Top 500 lists, the 90-day MozCast weather and SERP-feature series, and every Google update Moz has recorded since 2000.

Reference

What a Moz field actually contains

Fields that read differently from how they look. Every row was measured against live moz.com answers on 2026-11-15.

FieldWhat it holds
linking_root_domains, ranking_keywordsMoz prints these rounded (460.6k, 1.1m). The field is that figure expanded (460600); *_display is the printed text and *_is_rounded says whether it was rounded. 63 of 64 reports printed a rounded linking-root-domain count.
competitive_research.ranking_keywordsThe exact count (hubspot.com 356,615). On 10 of 10 domains it rounded to the same text domain_report printed (356.6k).
ranking_keywords_by_positionMoz's own split into positions 1-3, 4-10, 11-20 and 21+. The four buckets do not add up to Moz's own total (hubspot.com 346,989 against 356,615); both are returned, with the bucket sum in ranking_keywords_in_buckets.
domain (subdomain asked)Moz scores the root domain: blog.hubspot.com returned exactly the numbers and rows of hubspot.com. domain is what Moz names on the report.
has_link_datafalse when Moz has no links for the domain. Moz still answers, with Domain Authority 1, 0 linking root domains and no spam score; that is what a brand-new domain gets.
top_pages[].pageThe page as Moz prints it, without a scheme (www.hubspot.com/). url adds https://. Rows are Moz's, including odd ones it has indexed (example.com/phpMyAdmin/database[/table][/script).
suggestions[].suggestion_volumeThe volume shown in Moz's suggestion list. Asking for that keyword on its own can return a different monthly_volume: 5 of 10 were equal, "best crm software" was 1,178 in the list and 2,732 on its own.
listings[].field_matchPer field, whether the network's listing matches what you sent: match, different, missing or not_checked. A missing listing has status NotFound and null fields.
listings[].rating, review_countPublished by the networks that show ratings (Google 4.6 from 8,548 reviews and Yelp 4.4 from 9,945 for one Seattle restaurant). Directories that show no rating carry 0, as Moz returns them.
top_brands.list_updatedThe date Moz last updated its Top 500 brands page: 2024-02-14. Its ranking-keyword counts date from then and differ from today's domain_report.

Domain Authority and Page Authority are Moz's own 1-100 scores. Domain Authority and the linking-root-domain count on domain_report matched Moz's Top 500 list on 27 of 27 domains that the list prints the same way.

Live example

Real request and response JSON

Captured from the indexed primary action, domain_report, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/moz/v1/domain_report",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "domain": "hubspot.com"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "moz",
    "endpoint": "domain_report",
    "mode": "live",
    "latency_ms": 1776.5,
    "record_count": 1,
    "bytes": 98604,
    "cache_hit": false,
    "upstream_requests": 1,
    "has_link_data": true,
    "charged_credits": 3,
    "version": "0.1.0",
    "request_id": "1385d9c9d49c4c12",
    "queue_ms": 2.1,
    "fetched_at": "2026-11-15T18:52:18.895Z"
  },
  "data": {
    "domain": "hubspot.com",
    "requested_domain": "hubspot.com",
    "domain_url": "https://hubspot.com",
    "report_url": "https://moz.com/domain-analysis/hubspot.com",
    "domain_authority": 93,
    "linking_root_domains": 460600,
    "linking_root_domains_display": "460.6k",
    "linking_root_domains_is_rounded": true,
    "ranking_keywords": 356600,
    "ranking_keywords_display": "356.6k",
    "ranking_keywords_is_rounded": true,
    "spam_score_percent": 1,
    "spam_score_display": "1%",
    "home_page_authority": 80,
    "has_link_data": true,
    "top_pages": [
      {
        "rank": 1,
        "page": "www.hubspot.com/",
        "url": "https://www.hubspot.com/",
        "page_authority": 80
      },
      {
        "rank": 2,
        "page": "www.hubspot.com/marketing-statistics",
        "url": "https://www.hubspot.com/marketing-statistics",
        "page_authority": 77
      },
      {
        "rank": 3,
        "page": "legal.hubspot.com/privacy-policy",
        "url": "https://legal.hubspot.com/privacy-policy",
        "page_authority": 76
      }
    ],
    "top_pages_count": 7,
    "top_pages_note": null,
    "top_linking_domains": [
      {
        "rank": 1,
        "domain": "www.google.com",
        "url": "https://www.google.com",
        "domain_authority": 100
      },
      {
        "rank": 2,
        "domain": "youtube.com",
        "url": "https://youtube.com",
        "domain_authority": 100
      },
      {
        "rank": 3,
        "domain": "www.blogger.com",
        "url": "https://www.blogger.com",
        "domain_authority": 100
      }
    ],
    "top_linking_domains_count": 7,
    "top_linking_domains_note": null,
    "link_history": {
      "period_start": "2026-09-14",
      "period_end": "2026-11-13",
      "day_count": 61,
      "total_discovered": 28462,
      "total_lost": 23105,
      "net_change": 5357,
      "days": [
        {
          "date": "2026-11-13",
          "discovered": 13,
          "lost": 5,
          "net_change": 8
        },
        {
          "date": "2026-11-12",
          "discovered": 356,
          "lost": 213,
          "net_change": 143
        },
        {
          "date": "2026-11-11",
          "discovered": 419,
          "lost": 206,
          "net_change": 213
        }
      ]
    }
  }
}
Actions

What the Moz API does

ActionDescriptionConcrete use caseKey params
domain_reportMoz'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`.SEO teams call domain_report to get moz's free domain report for any domain.domain
keyword_metricsMoz 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.Content strategists call keyword_metrics to get moz Keyword Explorer for one keyword in one Google market.keyword, locale
competitive_researchMoz 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).Rank trackers call competitive_research to get moz Competitive Research for a domain.domain
local_scanMoz 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.AI answer-monitoring tools call local_scan to get moz Local listing scan for one business (US, Canada, UK).business_name, street_address, city, state, postal_code, ...
local_scan_resultThe current state of a Moz Local listing scan started with `local_scan`: progress, totals and every network checked so far.SEO teams call local_scan_result to get the current state of a Moz Local listing scan started with `local_scan`.scan_id
top_domainsMoz Top 500: the 500 most-linked domains on the web with their exact linking root domain count and Domain Authority, in Moz's order.Content strategists call top_domains to get moz Top 500.query, page, page_size
top_brandsMoz Top 500 US brands by Brand Authority, with each brand's ranking keyword count and the date Moz last updated the list.Rank trackers call top_brands to get moz Top 500 US brands by Brand Authority, with each brand's ranking keyword count and the dat….query, page, page_size
algorithm_updatesMoz'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.AI answer-monitoring tools call algorithm_updates to get moz's history of Google algorithm updates since 2000, newest first.year, status, query, page, page_size
mozcastMozCast, 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.SEO teams call mozcast to get mozCast, Moz's daily Google weather report.days, feature
Code samples

Call domain_report from your stack

curl -X POST https://api.reefapi.com/moz/v1/domain_report \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"domain":"hubspot.com"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.moz.domain_report with {"domain":"hubspot.com"}.
Use cases

Who uses this API and why

  • Check Domain Authority, spam score and top linking domains for a list of prospects or link partners.
  • Size a keyword in 27 Google markets: volume, difficulty and organic click-through rate.
  • Find a domain's top organic competitors and its exact ranking-keyword count by position.
  • Audit a local business's listings on Google, Bing, Apple Maps, Yelp, Facebook and 24 more networks.
  • Track Google ranking volatility (MozCast) and match it to Moz's record of algorithm updates.
FAQ

Questions developers ask before integrating

Is there a Moz API for Domain Authority?

Yes. The moz API on ReefAPI returns any domain's Domain Authority, spam score, linking root domains, ranking keywords, 7 top pages and 7 top linking domains as JSON, read from Moz's free tools, plus keyword volume and difficulty, organic competitors and a local listing scan.

Do I need a Moz account?

No. Everything is read from Moz's free, logged-out tools.

How many top pages and linking domains does domain_report return?

Moz's free report shows 7 of each, and the API returns those 7; 65 of 65 reports measured had 7 and 7. The full lists are in Moz's paid Link Explorer, which this API does not read.

How far back does the link history go?

Up to 61 days of discovered and lost linking domains, newest first (59 of 65 reports had 61 days; a small site had 11).

Which markets does keyword_metrics cover?

27 Google markets, Moz's own list: en-US, en-GB, en-CA, en-AU, en-IE, en-NZ, en-IN, de-DE, de-AT, de-CH, fr-FR, es-ES, es-MX, es-AR, it-IT, nl-NL, nl-BE, sv-SE, no-NO, da-DK, fi-FI, pl-PL, ro-RO, hr-HR, el-GR, uk-UA and ja-JP.

Why do some keyword calls take longer?

A keyword Moz has not looked up recently is computed on request. 14 of 21 measured calls answered in 2.4 to 6.2 seconds; the other 7 (for example "recette crepes" in fr-FR) took 34 to 46 seconds.

How long does a local listing scan take?

About a minute for 29 networks. local_scan waits up to 90 seconds by default and returns what is done with a scan_id: 2 of 3 new scans finished inside the call (66 and 75 seconds), the third was 97 percent done. local_scan_result returned all 5 scans read back later as finished. A business Moz scanned recently comes back finished at once.

Which countries does local_scan cover?

Moz offers the scan for the United States, Canada and the United Kingdom; finished scans of a Toronto and a London business returned all 29 networks. For a UK address, put the county or city in state.

Can competitive_research fail?

A domain Moz has not prepared recently is computed during the call: 17 of 17 such domains answered on the first call, in 32 seconds at the median and 74 at most. One very large domain, reddit.com, did not answer in 4 calls; a call that fails is not charged.

What is the Moz API?

Moz API is a ReefAPI endpoint group for domain authority, spam score, top pages and linking domains for any domain, keyword volume and difficulty, organic competitors, local listing scans, top 500 lists, mozcast and google update history. It returns live JSON through POST requests under /moz/v1.

Is the Moz API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Moz calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Moz login or account?

No login to Moz is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Moz data?

The page example is captured from a live domain_report call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Moz API use?

Moz actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

docs / moz

Moz

Domain Authority, spam score, top pages and linking domains for any domain, keyword volume and difficulty, organic competitors, local listing scans, Top 500 lists, MozCast and Google update history.

base /moz/v19 endpoints
post/moz/v1/domain_report3 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`.

ParameterAllowed / rangeDescription
domainrequired—A domain (hubspot.com), any link on it, or a moz.com/domain-analysis/<domain> link. IDN names are accepted (münchen.de).
Try in playground →
post/moz/v1/keyword_metrics3 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.

ParameterAllowed / rangeDescription
keywordrequired—The search term (up to 256 characters).
locale = en-USoptionalen-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-INGoogle market (language-country).
Try in playground →
post/moz/v1/competitive_research3 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).

ParameterAllowed / rangeDescription
domainrequired—A domain (hubspot.com), any link on it, or a moz.com/domain-analysis/<domain> link. IDN names are accepted (münchen.de).
Try in playground →
post/moz/v1/local_scan3 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.

ParameterAllowed / rangeDescription
business_namerequired—Business name as customers know it.
street_addressrequired—Street address.
cityrequired—City.
staterequired—State / province code (US: WA, CA: ON); for the UK the county or city (London). Moz rejects an empty value.
postal_coderequired—ZIP / postal code.
phoneoptional—Phone number (optional).
business_type = general_localoptionalgeneral_local · healthcare · restaurant_hospitality · retail_storefront · service_area_business · professional_services · automotive · personal_care_wellnessMoz Local business type.
wait_seconds = 90optional0–110How long this call waits for the scan (0 = start and return the scan_id at once).
Try in playground →
post/moz/v1/local_scan_result1 credit

The current state of a Moz Local listing scan started with `local_scan`: progress, totals and every network checked so far.

ParameterAllowed / rangeDescription
scan_idrequired—`scan_id` from local_scan.
Try in playground →
post/moz/v1/top_domains1 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.

ParameterAllowed / rangeDescription
queryoptional—Keep only rows whose domain contains this text (case-insensitive).
page = 1optional1–Page number (1-based).
page_size = 100optional1–500Rows per page (1-500).
Try in playground →
post/moz/v1/top_brands3 credits

Moz Top 500 US brands by Brand Authority, with each brand's ranking keyword count and the date Moz last updated the list.

ParameterAllowed / rangeDescription
queryoptional—Keep only rows whose domain contains this text (case-insensitive).
page = 1optional1–Page number (1-based).
page_size = 100optional1–500Rows per page (1-500).
Try in playground →
post/moz/v1/algorithm_updates3 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.

ParameterAllowed / rangeDescription
yearoptional2000–2100Only updates of this year (the page lists 2000-2026).
statusoptionalconfirmed · unconfirmedConfirmed by Google or not.
queryoptional—Text in the update name or Moz's description.
page = 1optional1–Page number (1-based).
page_size = 25optional1–300Rows per page (1-300).
Try in playground →
post/moz/v1/mozcast2 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.

ParameterAllowed / rangeDescription
days = 30optional1–90How many days back (newest first).
featureoptionallocal-packs · featured-snippets · knowledge-graph · videos · https-results · reviews · sitelinksOnly this SERP feature's series.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.