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.

api.limits.beta.rows

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": "25a85541-6681-4b3b-97af-80cb7663b735",
  "method": "beta.data.keyword.metrics.fetch",
  "params": {
    "data": {
      "serp_query": {
        "keyword": "domain authority",
        "locale": "en-US",
        "device": "desktop",
        "engine": "google"
      }
    }
  }
}'