Moz API

Domain Authority, spam score, keyword difficulty and local listings for any domain or business

endpoints
9
credits per call
1–3

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.

POST/moz/v1/domain_report
Real result, captured Nov 15, 2026
spam_score_percent1
spam_score_display
1%
domain
hubspot.com
requested_domain
hubspot.com
domain_authority
93
ranking_keywords
356,600
9 active endpoints, on 1, 2 and 3 credit tiers.domain_report · keyword_metrics · competitive_research · local_scan · local_scan_result · top_domains+3 more ↓OpenAPI 3.0 spec ↗

3 credits per call≈ $3/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Moz API

5 of 9 endpoints, ready to run

View docs ↗

Domain Authority, spam score, top pages and linking domains

3 credits1 required · 0 optional
POST/moz/v1/domain_report
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Moz endpoints does ReefAPI ship?

9 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • domain_report

    3 cr

    Moz's free domain report for any domain.

    required
    domain
    optional
    —
  • keyword_metrics

    3 cr

    Moz Keyword Explorer for one keyword in one Google market.

    required
    keyword
    optional
    locale
  • competitive_research

    3 cr

    Moz Competitive Research for a domain.

    required
    domain
    optional
    —
  • local_scan

    3 cr

    Moz Local listing scan for one business (US, Canada, UK).

    required
    business_name, street_address, city, state, postal_code
    optional
    phone, business_type, wait_seconds
  • local_scan_result

    1 cr

    The current state of a Moz Local listing scan started with local_scan.

    required
    scan_id
    optional
    —
  • top_domains

    1 cr

    Moz Top 500.

    required
    —
    optional
    query, page, page_size
  • top_brands

    3 cr

    Moz Top 500 US brands by Brand Authority, with each brand's ranking keyword count and the dat…

    required
    —
    optional
    query, page, page_size
  • algorithm_updates

    3 cr

    Moz's history of Google algorithm updates since 2000, newest first.

    required
    —
    optional
    year, status, query, page, page_size
  • mozcast

    2 cr

    MozCast, Moz's daily Google weather report.

    required
    —
    optional
    days, feature

Every parameter, every allowed value →

Missing a Moz endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Moz API works

Moz is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /moz/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a domain to its authority, competitors and keyword gaps

Score a domain, see who it competes with organically, then size the keywords Moz suggests.

01domain_report?domain=hubspot.com
GET/moz/v1/domain_report?domain=hubspot.com

Domain Authority 93, 460.6k linking root domains, 356.6k ranking keywords, spam score 1%, the 7 top pages and 7 top linking domains, 61 days of link history.

02competitive_research?domain=hubspot.com
GET/moz/v1/competitive_research?domain=hubspot.com

356,615 ranking keywords split by position, 3 organic competitors with the same figures, 5 keyword opportunities with traffic lift.

03keyword_metrics?keyword=<opportunity>&locale=en-US
GET/moz/v1/keyword_metrics?keyword=<opportunity>&locale=en-US

Monthly volume, difficulty and organic click-through rate for each opportunity, plus 5 more suggestions.

A domain's authority and link profile, its organic competitors, and the keywords worth targeting, with Moz's volume and difficulty for each.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "moz",
    "endpoint": "domain_report",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

Coverage

Moz coverage, measured

Every number below was read from live moz.com answers on 2026-11-15.

Domain reports

65 of 65 calls answered across 65 domains (news, retail, software, universities, small local sites, IDN); median 1.4 seconds. Each has 7 top pages, 7 top linking domains and up to 61 days of link history.

Accuracy

Domain Authority and linking root domains matched Moz's Top 500 list on 27 of 27 domains printed the same way; competitive_research's exact ranking-keyword count rounded to domain_report's printed figure on 10 of 10 domains, and its Domain Authority matched on 10 of 10.

Keywords

21 of 21 keyword calls answered in 12 markets; volume, difficulty, organic CTR and 5 suggestions on 21 of 21.

Competitors

21 of 22 calls on domains Moz has data for answered, including 17 of 17 domains asked for the first time; median 26 seconds. Moz answers "no data" for some domains (salesforce.com).

Local scan: United States, Canada, United Kingdom

29 networks per business; on 8 finished scans in the US, Canada and the UK, 84 network rows listed the business: 84 with the listing link, name and address, 68 with a phone, 82 with a website, 20 with a rating and review count.

Lists

Top 500 domains (500 rows, exact linking root domains), Top 500 US brands (500 rows, list updated 2024-02-14), 279 Google updates from 2000 to 2026 (196 confirmed, 83 unconfirmed), MozCast 90 days and 7 SERP features.

Limits

7 top pages and 7 linking domains per domain (Moz's free report); 5 keyword suggestions and 3 competitors per call; no backlink lists, anchor texts or keyword ranking lists, which Moz keeps behind its login.

Use cases

What people build with Moz

The jobs this data is most often used for.

01

Check Domain Authority, spam score and top linking domains for a list of prospects or link partners.

02

Size a keyword in 27 Google markets: volume, difficulty and organic click-through rate.

03

Find a domain's top organic competitors and its exact ranking-keyword count by position.

04

Audit a local business's listings on Google, Bing, Apple Maps, Yelp, Facebook and 24 more networks.

9

endpoints

1/2/3

credits per call

Pricing

What Moz data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/moz/v1/domain_report",
    headers={"x-api-key": REEF_KEY},
    json={
        "domain": "hubspot.com"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Moz.

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.

Same key

16 Search & SEO APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Moz, you are one call away from the rest of the category — no second contract, no second integration.

Already paying for something else?Moz vs ZenRowsMoz vs FirecrawlMoz vs Oxylabs
Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-15.