DataSiteMetricsDistributionsFetch

Search API documentation

⌘K

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.

Each distribution is named with the pattern METRIC_BY_MEASURE, where METRIC has the same meaning as the stand-alone metric with the same name, and MEASURE determines how that metric is split into buckets. MEASURE can have the following values:

root_domains metric is bucketed by the number of root domains linking to the source of each link. The ranges represented in each bucket are: - [0, 1-9, 10-99, 100-999, 1000-9999, 10000-99999, 100000-999999, 1000000-9999999, 10000000-99999999, 100000000+]
domain_authority metric is bucketed by the domain authority of the source root domain of each link. The ranges represented in each bucket are: - [1-10, 11-20, 21-30, 31-40, 41-50, 51-60, 61-70, 71-80, 81-90, 91-100]
spam_score metric is bucketed by the spam score of the source root domain of each link. The ranges represented in each bucket are: - [1-10, 11-20, 21-30, 31-40, 41-50, 51-60, 61-70, 71-80, 81-90, 91-100]

For some source root domains, a spam score is not available. Links from these domains are not counted in the response distribution.

JSON-RPC Method:

data.site.metrics.distributions.fetch

Go to Example Code

Request

site_query

object

A SiteQuery provides a target URL along with a scope to define how the query is parsed.

Response

site_query

object

Represents a parsed site query.

site_metrics_distributions

object

Represents a Site Metrics Distribution object.

1{
2  "site_query": {
3    "query": "https://moz.com",
4    "scope": "domain"
5  },
6  "site_metrics_distributions": {
7    "root_domains_to_page_by_root_domains": [
8      20993,
9      53357,
10      39763,
11      35898,
12      21599,
13      5898,
14      864,
15      61,
16      11,
17      0
18    ],
19    "root_domains_to_root_domain_by_root_domains": [
20      34239,
21      105888,
22      86245,
23      78604,
24      45604,
25      9317,
26      1128,
27      71,
28      14,
29      0
30    ],
31    "nofollow_root_domains_to_root_domain_by_root_domains": [
32      4575,
33      21287,
34      20473,
35      20430,
36      13822,
37      2329,
38      188,
39      12,
40      3,
41      0
42    ],
43    "root_domains_to_page_by_domain_authority": [
44      112607,
45      25379,
46      15208,
47      9859,
48      5712,
49      4467,
50      2192,
51      1512,
52      1010,
53      498
54    ],
55    "root_domains_to_subdomain_by_domain_authority": [
56      133631,
57      31621,
58      18842,
59      12238,
60      6981,
61      5305,
62      2525,
63      1699,
64      1125,
65      526
66    ],
67    "root_domains_to_root_domain_by_domain_authority": [
68      221189,
69      57409,
70      33171,
71      21346,
72      11227,
73      8792,
74      3770,
75      2216,
76      1382,
77      608
78    ],
79    "nofollow_root_domains_to_root_domain_by_domain_authority": [
80      45841,
81      15383,
82      8666,
83      5973,
84      3230,
85      2226,
86      951,
87      468,
88      274,
89      107
90    ],
91    "pages_to_root_domain_by_spam_score": [
92      71801563,
93      11137580,
94      6004361,
95      6916159,
96      4496245,
97      2694223,
98      1621052,
99      4531426,
100      576916,
101      245654
102    ],
103    "nofollow_pages_to_root_domain_by_spam_score": [
104      4555388,
105      762635,
106      556323,
107      238022,
108      98816,
109      76580,
110      50641,
111      798280,
112      327778,
113      13755
114    ],
115    "root_domains_to_page_by_spam_score": [
116      74166,
117      25512,
118      12151,
119      8552,
120      6511,
121      5329,
122      3520,
123      2758,
124      2175,
125      1350
126    ],
127    "root_domains_to_subdomain_by_spam_score": [
128      89553,
129      30189,
130      14725,
131      10320,
132      8075,
133      6851,
134      4596,
135      3519,
136      2655,
137      1471
138    ],
139    "root_domains_to_root_domain_by_spam_score": [
140      156089,
141      48474,
142      24953,
143      17385,
144      13206,
145      11197,
146      7846,
147      6160,
148      4473,
149      2248
150    ],
151    "nofollow_root_domains_to_root_domain_by_spam_score": [
152      37714,
153      10480,
154      5463,
155      3435,
156      2355,
157      2119,
158      1462,
159      1034,
160      589,
161      142
162    ]
163  }
164}

Example Code

Quota Usage

Uses one row per successful call.

api.limits.data.rows