DataSiteMetricsFetchMultiple

Use this endpoint to get metrics such as Domain Authority, Page Authority, Spam Score, link counts and more about one or more URLs

JSON-RPC Method Name

data.site.metrics.fetch.multiple

Request Parameters

site_queries

array

query

string

A URL to query for.

scope

string

The scope to parse the query with. Providing a less detailed scope than the provided URL will alter the input. e.g. moz.com/foo/bar with a scope of domain will ultimately resolve to moz.com

Acceptable Values:

domain

subdomain

subfolder

url

Response Values

results_by_site

array

site_query

object

Represents a parsed site query.

site_metrics

object

Represents a Site Metrics object.

errors_by_site

array

site_query

object

Represents a parsed site query.

error

object

An error returned from the API.

Sample Request

1{
2  "site_queries": [
3    {
4      "query": "https://moz.com/",
5      "scope": "domain"
6    },
7    {
8      "query": "https://moz.com/blog",
9      "scope": "url"
10    }
11  ]
12}

Sample Response

1{
2  "results_by_site": [
3    {
4      "site_query": {
5        "query": "https://moz.com/blog",
6        "scope": "url",
7        "original_site_query": {
8          "query": "moz.com/blog",
9          "scope": "url"
10        },
11        "site_query_suggestion": null
12      },
13      "site_metrics": {
14        "page": "moz.com/blog",
15        "subdomain": "moz.com",
16        "root_domain": "moz.com",
17        "title": "The Moz Blog [SEO] - Moz",
18        "last_crawled": "2024-11-02",
19        "http_code": 200,
20        "pages_to_page": 710698,
21        "nofollow_pages_to_page": 7073,
22        "redirect_pages_to_page": 812,
23        "external_pages_to_page": 461992,
24        "external_nofollow_pages_to_page": 7073,
25        "external_redirect_pages_to_page": 273,
26        "deleted_pages_to_page": 198443,
27        "root_domains_to_page": 10409,
28        "indirect_root_domains_to_page": 2107,
29        "deleted_root_domains_to_page": 1564,
30        "nofollow_root_domains_to_page": 1903,
31        "pages_to_subdomain": 91619477,
32        "nofollow_pages_to_subdomain": 13403603,
33        "redirect_pages_to_subdomain": 47747395,
34        "external_pages_to_subdomain": 67812167,
35        "external_nofollow_pages_to_subdomain": 13383578,
36        "external_redirect_pages_to_subdomain": 41154251,
37        "deleted_pages_to_subdomain": 19706071,
38        "root_domains_to_subdomain": 186553,
39        "deleted_root_domains_to_subdomain": 29562,
40        "nofollow_root_domains_to_subdomain": 38718,
41        "pages_to_root_domain": 93088010,
42        "nofollow_pages_to_root_domain": 13513706,
43        "redirect_pages_to_root_domain": 47753026,
44        "external_pages_to_root_domain": 68942297,
45        "external_indirect_pages_to_root_domain": 44373352,
46        "external_nofollow_pages_to_root_domain": 13492593,
47        "external_redirect_pages_to_root_domain": 41157669,
48        "deleted_pages_to_root_domain": 20137876,
49        "root_domains_to_root_domain": 188816,
50        "indirect_root_domains_to_root_domain": 27597,
51        "deleted_root_domains_to_root_domain": 30393,
52        "nofollow_root_domains_to_root_domain": 38829,
53        "page_authority": 70,
54        "domain_authority": 90,
55        "link_propensity": 0.01030706428,
56        "spam_score": 3,
57        "root_domains_from_page": 6,
58        "nofollow_root_domains_from_page": 0,
59        "pages_from_page": 8,
60        "nofollow_pages_from_page": 0,
61        "root_domains_from_root_domain": 83316,
62        "nofollow_root_domains_from_root_domain": 69184,
63        "pages_from_root_domain": 398300,
64        "nofollow_pages_from_root_domain": 261292,
65        "pages_crawled_from_root_domain": 8083388
66      }
67    },
68    {
69      "site_query": {
70        "query": "https://moz.com",
71        "scope": "domain",
72        "original_site_query": {
73          "query": "moz.com",
74          "scope": "domain"
75        },
76        "site_query_suggestion": null
77      },
78      "site_metrics": {
79        "page": "moz.com/",
80        "subdomain": "moz.com",
81        "root_domain": "moz.com",
82        "title": "Moz - SEO Software for Smarter Marketing",
83        "last_crawled": "2024-11-04",
84        "http_code": 200,
85        "pages_to_page": 14888332,
86        "nofollow_pages_to_page": 7348137,
87        "redirect_pages_to_page": 3685769,
88        "external_pages_to_page": 14630805,
89        "external_nofollow_pages_to_page": 7348137,
90        "external_redirect_pages_to_page": 3685309,
91        "deleted_pages_to_page": 2785246,
92        "root_domains_to_page": 45303,
93        "indirect_root_domains_to_page": 10655,
94        "deleted_root_domains_to_page": 7248,
95        "nofollow_root_domains_to_page": 9374,
96        "pages_to_subdomain": 91619477,
97        "nofollow_pages_to_subdomain": 13403603,
98        "redirect_pages_to_subdomain": 47747395,
99        "external_pages_to_subdomain": 67812167,
100        "external_nofollow_pages_to_subdomain": 13383578,
101        "external_redirect_pages_to_subdomain": 41154251,
102        "deleted_pages_to_subdomain": 19706071,
103        "root_domains_to_subdomain": 186553,
104        "deleted_root_domains_to_subdomain": 29562,
105        "nofollow_root_domains_to_subdomain": 38718,
106        "pages_to_root_domain": 93088010,
107        "nofollow_pages_to_root_domain": 13513706,
108        "redirect_pages_to_root_domain": 47753026,
109        "external_pages_to_root_domain": 68942297,
110        "external_indirect_pages_to_root_domain": 44373352,
111        "external_nofollow_pages_to_root_domain": 13492593,
112        "external_redirect_pages_to_root_domain": 41157669,
113        "deleted_pages_to_root_domain": 20137876,
114        "root_domains_to_root_domain": 188816,
115        "indirect_root_domains_to_root_domain": 27597,
116        "deleted_root_domains_to_root_domain": 30393,
117        "nofollow_root_domains_to_root_domain": 38829,
118        "page_authority": 75,
119        "domain_authority": 90,
120        "link_propensity": 0.01030706428,
121        "spam_score": 3,
122        "root_domains_from_page": 10,
123        "nofollow_root_domains_from_page": 0,
124        "pages_from_page": 13,
125        "nofollow_pages_from_page": 0,
126        "root_domains_from_root_domain": 83316,
127        "nofollow_root_domains_from_root_domain": 69184,
128        "pages_from_root_domain": 398300,
129        "nofollow_pages_from_root_domain": 261292,
130        "pages_crawled_from_root_domain": 8083388
131      }
132    }
133  ],
134  "errors_by_site": []
135}

Quota Usage

Uses one row per returned result.

api.limits.beta.rows

Example Code

curl -X POST https://api.moz.com/jsonrpc \
-H "x-moz-token: <YOUR_MOZ_TOKEN>" \
-H "Content-Type: application/json" \
-d '
{
  "jsonrpc": "2.0",
  "id": "2a03012e-3ef1-4119-a705-eb2fa404550e",
  "method": "data.site.metrics.fetch.multiple",
  "params": {
    "data": {
      "site_queries": [
        {
          "query": "https://moz.com/",
          "scope": "domain"
        },
        {
          "query": "https://moz.com/blog",
          "scope": "url"
        }
      ]
    }
  }
}'