-
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
Generate Keyword Metrics
JSON-RPC Method:
data.keyword.metrics.generateTrigger on-demand collection of a SERP and return the refreshed metrics once collection is complete.
This is an asynchronous method. It always responds with a pending async call, which is polled with async.call.lookup.
On-demand collection is protected by a global rate limit of 2000 requests per hour across all callers; exceeding it returns a RateLimitError.
Throws RunError if a SERP for this query was collected less than 24 hours ago.
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).
The action returns a `pending` async call; the metrics are delivered on the completed call once collection is complete. Poll the async call with `async.call.lookup` to retrieve the result below.
async_call
object
Charges 6 rows for the on-demand SERP collection plus one row per returned (non-null) metric, up to a maximum 11 rows total. Unavailable (null) metrics are not charged.
api.limits.data.rows