-
SEO Learning Center
Broaden your SEO knowledge with resources for all skill levels.
-
The Beginner's Guide to SEO
If you're brand new to SEO, start here.
-
SEO Q&A
Get answers from the Moz Community.
-
Free Downloads and More
Quick access to whitepapers, reports, guides, webinars, and case studies.
-
Help Hub
Learn how to use Moz products.
-
Community & Events
Connect with over 600k online marketers.
-
SEO Training
Instructor-led classes and seminars
Research Tools
Manage Location
Data > Keyword > SERP
Fetch SERP
JSON-RPC Method:
data.keyword.serp.fetchRetrieve the most recently collected SERP for a given query. Throws NotFoundError when nothing in cache is newer than options.max_age.
Request
serp_query
object
The SERP query object describes a keyword or search phrase in combination with several options to specify how the query is run (i.e. how a SERP should be retrieved for this keyword if necessary).
options
object
Options to further refine the cached SERP that is returned.
Response
Results include the parsed Serp Query, the resolved options, and the SERP.
serp_query
object
Represents a SERP query object.
options
object
Resolved options echoed on the response.
serp
object
Fetched SERP, including when it was collected, keyword metrics, and results.
1{
2 "serp_query": {
3 "keyword": "domain authority",
4 "locale": "en-US",
5 "device": "desktop",
6 "engine": "google",
7 "vicinity": ""
8 },
9 "options": {
10 "max_age": 31536000
11 },
12 "serp": {
13 "metadata": {
14 "collected_at": "2024-01-01T00:00:00Z"
15 },
16 "metrics": {
17 "volume": 2200,
18 "difficulty": 69,
19 "organic_ctr": 79,
20 "priority": 57,
21 "intent": {
22 "primary_intents": [
23 "informational"
24 ],
25 "all_intents": [
26 {
27 "label": "informational",
28 "score": 0.59
29 },
30 {
31 "label": "navigational",
32 "score": 0.19
33 },
34 {
35 "label": "commercial",
36 "score": 0.12
37 },
38 {
39 "label": "transactional",
40 "score": 0.1
41 }
42 ]
43 }
44 },
45 "results": [
46 {
47 "type": "regular",
48 "title": "Free Domain Authority Checker",
49 "url": "https://moz.com/domain-analysis",
50 "description": "Check the Domain Authority, Page Authority, ranking keywords, and top search competitors for a domain.",
51 "position": "center",
52 "position_index": 1,
53 "rank": 1,
54 "brand_authority": 63,
55 "traits": [
56 "sitelinks"
57 ],
58 "url_metrics": {
59 "page": "moz.com/domain-analysis",
60 "subdomain": "moz.com",
61 "root_domain": "moz.com",
62 "title": "Free Domain Authority Checker",
63 "last_crawled": "2026-08-30",
64 "http_code": 200,
65 "pages_to_page": 123,
66 "nofollow_pages_to_page": 5,
67 "redirect_pages_to_page": 10,
68 "external_pages_to_page": 100,
69 "external_nofollow_pages_to_page": 3,
70 "external_redirect_pages_to_page": 8,
71 "deleted_pages_to_page": 2,
72 "root_domains_to_page": 50,
73 "indirect_root_domains_to_page": 15,
74 "deleted_root_domains_to_page": 1,
75 "nofollow_root_domains_to_page": 2,
76 "pages_to_subdomain": 500,
77 "nofollow_pages_to_subdomain": 20,
78 "redirect_pages_to_subdomain": 40,
79 "external_pages_to_subdomain": 400,
80 "external_nofollow_pages_to_subdomain": 15,
81 "external_redirect_pages_to_subdomain": 30,
82 "deleted_pages_to_subdomain": 10,
83 "root_domains_to_subdomain": 100,
84 "deleted_root_domains_to_subdomain": 5,
85 "nofollow_root_domains_to_subdomain": 10,
86 "pages_to_root_domain": 5000,
87 "nofollow_pages_to_root_domain": 200,
88 "redirect_pages_to_root_domain": 400,
89 "external_pages_to_root_domain": 4000,
90 "external_indirect_pages_to_root_domain": 1000,
91 "external_nofollow_pages_to_root_domain": 150,
92 "external_redirect_pages_to_root_domain": 300,
93 "deleted_pages_to_root_domain": 100,
94 "root_domains_to_root_domain": 500,
95 "indirect_root_domains_to_root_domain": 200,
96 "deleted_root_domains_to_root_domain": 50,
97 "nofollow_root_domains_to_root_domain": 100,
98 "page_authority": 78,
99 "domain_authority": 91,
100 "link_propensity": 0.9,
101 "spam_score": 1,
102 "root_domains_from_page": 10,
103 "nofollow_root_domains_from_page": 1,
104 "pages_from_page": 50,
105 "nofollow_pages_from_page": 5,
106 "root_domains_from_root_domain": 1000,
107 "nofollow_root_domains_from_root_domain": 100,
108 "pages_from_root_domain": 5000,
109 "nofollow_pages_from_root_domain": 500,
110 "pages_crawled_from_root_domain": 10000
111 },
112 "results": [],
113 "sitelinks": [
114 {
115 "type": "regular",
116 "title": "Link Explorer",
117 "url": "https://moz.com/link-explorer",
118 "description": null,
119 "position": null,
120 "position_index": null,
121 "rank": null,
122 "brand_authority": null,
123 "traits": [],
124 "url_metrics": null,
125 "results": [],
126 "sitelinks": [],
127 "one_line_sitelinks": []
128 }
129 ],
130 "one_line_sitelinks": [
131 {
132 "type": "regular",
133 "title": "Domain Analysis",
134 "url": "https://moz.com/domain-analysis",
135 "description": null,
136 "position": null,
137 "position_index": null,
138 "rank": null,
139 "brand_authority": null,
140 "traits": [],
141 "url_metrics": null,
142 "results": [],
143 "sitelinks": [],
144 "one_line_sitelinks": []
145 }
146 ]
147 },
148 {
149 "type": "featured_snippets",
150 "title": null,
151 "url": null,
152 "description": null,
153 "position": "top",
154 "position_index": 0,
155 "rank": null,
156 "brand_authority": null,
157 "traits": [],
158 "url_metrics": null,
159 "results": [
160 {
161 "type": "regular",
162 "title": "What is Domain Authority?",
163 "url": "https://moz.com/learn/seo/domain-authority",
164 "description": "Domain Authority (DA) is a search engine ranking score developed by Moz.",
165 "position": null,
166 "position_index": null,
167 "rank": null,
168 "brand_authority": null,
169 "traits": [],
170 "url_metrics": null,
171 "results": [],
172 "sitelinks": [],
173 "one_line_sitelinks": []
174 }
175 ],
176 "sitelinks": [],
177 "one_line_sitelinks": []
178 }
179 ]
180 }
181}Example Code
Quota Usage
Costs 15 rows per call, less 1 row for each null keyword metric returned (volume, difficulty, organic_ctr, priority, intent). As an example, a call that fails to return intent will cost 14 rows.
api.limits.data.rows