Moz API V3 Overview

Looking for documentation for the current iteration of the Moz API? Access it here!

In this guide, you’ll learn more about Moz API V3 and its available methods.

Quick Links

• Introduction
• Why are we building the Moz API V3?
• API V3 methods
• API V3 documentation
• What are “methods” in the V3 API? Don’t you mean “endpoints”?

The Moz API is a powerful tool for users who want to analyze the search landscape, build custom dashboards or SEO reporting scripts, enrich their own SaaS applications (with proper attribution), and much more.

All V2 endpoints are now available in the Moz API V3, or unified Moz API.

Authentication with the new Moz API V3 is easier than ever. For more information on accessing the Moz API V3 endpoints, be sure to check out the Getting Started section of the updated API Documentation Hub. 

V3 of the Moz API provides you with more data solutions to help you make informed SEO decisions. With expanded methods and a revamped JSON-RPC format, you can expect a more intuitive API design, simplified authentication, and a better overall developer experience. 

In addition to the link data available via V2, Moz API V3 will offer a rich collection of data for keyword and site research through the methods now available. Be sure to check out our flexible subscription options to find a data solution that fits your project needs. These affordable plans allow for scalability and growth, making the Moz API accessible for any budget size.

• Access the Moz API V3 documentation

The following methods are currently available via Moz API V3:

Global

• Get Global Top Ranking Domains — Get the top-ranking domains globally.
• Get Top Ranking Pages – Get the top-ranking pages globally.

Keyword

• Fetch Search Intent – Retrieve the most recent Search Intent scores (navigational, informational, commercial, and transactional) for any keyword in our database. 
• List Related Keywords – Retrieve a list of related Keyword Suggestions for a given input keyword. 
• Metrics
  • Fetch Difficulty – Retrieve the most recent difficulty metric for any keyword that exists in our database.
  • Fetch All — Retrieve the most recent difficulty, volume, organic CTR, and/or priority metrics for any keyword in our database.
  • Fetch Opportunity (CTR) – Retrieve the most recent organic CTR (opportunity) metric for any keyword that exists in our database.
  • Fetch Priority – Retrieve the most recent priority metric for any keyword that exists in our database.
  • Fetch Volume – Retrieve the most recent volume metric for any keyword that exists in our database.

Site

• Get Anchor Texts list — Use this endpoint to get data about anchor text used to link to a specified site. This can be helpful when trying to understand how people are linking to and talking about your brand. Additionally, this information can be used for topic research to identify clusters or trends in how people are talking about (or linking to) particular sites. 
• List Recently Gained Links — This endpoint will return information about external root domains that added new links to a target during the past 60 days.
• List Recently Lost Links – This endpoint will return information about root domains that removed links to a target during the past 60 days.
• List Linking Domains – Use this endpoint to get a list of linking root domains to a target, with information about each root domain and the aggregate number of links to the target.
• Count Ranking Keywords – Retrieve a summary of the number of keywords for which the provided query (domain, subdomain, or page) ranks in the top 50.
• List Ranking Keywords – Retrieve a list of keywords for which the provided site (domain, subdomain, subfolder, or page) ranks in the top 50, along with the ranking position, Difficulty, and Monthly Volume for each keyword.
• Get Final Redirect Target – Use this endpoint to see the final redirect target of a page after following known redirects in the index. This data can be helpful for tasks like technical audits, checking that redirects were implemented correctly after domain migrations or page moves.
• List Top Pages – Use this endpoint to return a list of the top pages on a target domain, sorted by descending page authority, linking root domains, or external linking pages.
• Link
  • Filter Link by Anchor Text – Use this endpoint to get a list of links to a target where the anchor text exactly matches a particular string.
  • Filter Links by Domain – Use this endpoint to find links pointing to a target only if they originate from a particular root domain. Results sorted by descending Page Authority.
  • Fetch Link Intersects – This endpoint returns information about sites that point to two or more specified domains, or that point at some domains but not others. It can be thought of as a Venn diagram or set construction tool for links.
  • List Links – Use this endpoint to get a list of links to a target.
  • Get Multiple Link Status – Use this endpoint to get the status of multiple links from a source to a target.
  • Get Link Status – Use this endpoint to get the status of a link from a source to a target.
• Metrics
  • Fetch Brand Authority™ – This endpoint returns a Brand Authority score for the provided target. Use this metric to understand the strength of your website’s brand, benchmark against competitors, and more.
  • Fetch Site Metrics Distributions – Use this endpoint to get information about how links to one or more target sites are distributed based on the source site's metrics, such as Domain Authority.
  • Fetch Multiple Site Metrics – Use this endpoint to get metrics such as Domain Authority, Page Authority, Spam Score, link counts and more about one or more URLs
  • Fetch Site Metrics – Use this endpoint to get metrics such as Domain Authority, Page Authority, Spam Score, link counts, and more for one URL.
  • Fetch Site Metric Histories – Use this endpoint to get daily or monthly metric histories for a single site. Histories can be returned as absolute values, or relative +/- deltas.

Quota

• Fetch Quota – Check how much quota is used/available for the current billing period, as well as additional information about the quota such as whether or not overages are enabled.

Metadata

• Fetch Current Index ID – Use this endpoint to track when the index is updated with new data. When queried, the endpoint returns an ID that changes when the data in the index changes.

Ready to get started with Moz API V3 and access the new methods? Check out the updated documentation in our API Documentation Hub.

Unlike an HTTP REST API, the Moz API V3 exposes a single URL that accepts remote procedure calls. Therefore, we don't talk about "endpoints" in for V3 (a distinct URL + HTTP method that corresponds with some action on a resource), but rather "methods" (the name of the function to be executed by the API server). The method name is passed in the body of the request to the API URL, as per the JSON-RPC 2.0 spec. For developers who are more familiar with HTTP REST patterns, you can think of the Moz API methods as playing a similar role to HTTP endpoints.

• Learn more about method structure