-
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
BetaDataKeywordMetricsFetch
Retrieve the most recent difficulty, volume, organic CTR, and/or priority metrics for any keyword that exists in our database.
JSON-RPC Method Name
beta.data.keyword.metrics.fetch
Request Parameters
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).
Response Values
keyword_metrics
object
Available metrics for a given keyword. If a value is null, it could not be calculated when the keyword was last collected.
serp_query
object
Represents a SERP query object.
Sample Requests
Sample Responses
Quota Usage
Uses one row per returned value, for a max of 4. Any unavailable (null) values will be discounted from the total row usage.
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": "ff9dedbb-f798-43c1-a502-ccca2f5f18dd",
"method": "beta.data.keyword.metrics.fetch",
"params": {
"data": {
"serp_query": {
"keyword": "domain authority",
"locale": "en-US",
"device": "desktop",
"engine": "google"
}
}
}
}'