-
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
Data > Keyword > Metrics
Fetch Difficulty
JSON-RPC Method:
data.keyword.metrics.difficulty.fetchRetrieve the most recent difficulty metric for any keyword that exists in our database.
Throws NotFoundError when the cached metrics are older than options.max_age.
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 keyword metrics that are returned. include_intent defaults to false if not provided.
Results include both the parsed Serp Query along with the keyword metrics. If a value cannot be found, a `NotFoundError` is thrown.
keyword_metrics
object
Available metrics for a given keyword. In this action only difficulty will have a value, all other metrics will always be null.
serp_query
object
Represents a SERP query object.
options
object
Resolved options echoed on the response.
1{
2 "serp_query": {
3 "keyword": "domain authority",
4 "locale": "en-US",
5 "device": "desktop",
6 "engine": "google",
7 "vicinity": ""
8 },
9 "options": {
10 "include_intent": false,
11 "max_age": 31536000
12 },
13 "keyword_metrics": {
14 "metadata": {
15 "collected_at": "2026-07-13T21:11:40Z"
16 },
17 "volume": null,
18 "difficulty": 69,
19 "organic_ctr": null,
20 "priority": null,
21 "intent": null
22 }
23}Uses one row per call.
api.limits.data.rows