BetaDataKeywordSearchIntentFetch

Retrieve the most recent search intent scores (navigational, informational, commercial, and transactional) for any keyword that exists in our database. Note that data availability may be limited while this method is in beta.

JSON-RPC Method Name

beta.data.keyword.search.intent.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). Search intent has a smaller set of acceptable input values for certain fields than other methods which accept SERP queries such as fetch keyword metrics.

Response Values

keyword_intent

object

Information for the intent of a given keyword.

serp_query

object

Represents a SERP query object.

Sample Requests

Sample Response

1{
2  "serp_query": {
3    "keyword": "domain authority",
4    "locale": "en-US",
5    "device": "desktop",
6    "engine": "google",
7    "vicinity": ""
8  },
9  "keyword_intent": {
10    "primary_intents": [
11      "informational"
12    ],
13    "all_intents": [
14      {
15        "label": "informational",
16        "score": 0.59
17      },
18      {
19        "label": "navigational",
20        "score": 0.19
21      },
22      {
23        "label": "commercial",
24        "score": 0.12
25      },
26      {
27        "label": "transactional",
28        "score": 0.1
29      }
30    ]
31  }
32}

Quota Usage

Uses one row per successful call.

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": "7ee2bab8-e2bf-4c9d-ba2c-c5a02cce3dfd",
  "method": "beta.data.keyword.search.intent.fetch",
  "params": {
    "data": {
      "serp_query": {
        "keyword": "domain authority",
        "locale": "en-US",
        "device": "desktop",
        "engine": "google"
      }
    }
  }
}'