DataKeywordSearchIntentFetch

Retrieve the most recent search intent scores (navigational, informational, commercial, and transactional) for any keyword that exists in our database.

JSON-RPC Method Name

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.data.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": "26523dc3-e234-47bd-b098-10a96f9edea3",
  "method": "data.keyword.search.intent.fetch",
  "params": {
    "data": {
      "serp_query": {
        "keyword": "domain authority",
        "locale": "en-US",
        "device": "desktop",
        "engine": "google"
      }
    }
  }
}'