BetaDataSiteRankingKeywordsList

Retrieve a list of keywords for which the provided site (domain, subdomain, subfolder, or page) ranks in the top 50, along with the ranking position and the difficulty and monthly search volume for each keyword.

JSON-RPC Method Name

beta.data.site.ranking.keywords.list

Request Parameters

target_query

object

A TargetQuery provides a target URL along with several options to specify how the query is run.

options

object

The options used when generating site ranking keywords result.

page

object

Response Values

ranking_keywords

array

keyword

string

The keyword that is ranked for. Assume the same locale as the provided input.

ranking_page

string

The exact URL that ranks for the given keyword.

rank_position

number

The position of the given page for the given keyword on a SERP.

difficulty

number | null

How difficult the keyword is to rank for - between 1 and 100 with 100 being the most difficult. If not available, will be null.

volume

number | null

The approximate monthly search volume for the given keyword. If not available, will be null.

target_query

object

Represents a parsed target query.

options

object

The options used when generating site ranking keywords result.

page

object

Control how much data is returned by providing a specific page number (n) and limit to the number of results in a given page.

Sample Requests

Sample Response

1{
2  "target_query": {
3    "query": "moz.com",
4    "scope": "domain",
5    "locale": "en-US"
6  },
7  "options": {
8    "sort": "rank"
9  },
10  "page": {
11    "n": 0,
12    "limit": 50
13  },
14  "ranking_keywords": [
15    {
16      "keyword": "moz",
17      "ranking_page": "https://moz.com/",
18      "rank_position": 1,
19      "difficulty": 72,
20      "volume": 6133
21    },
22    {
23      "keyword": "domain authority checker",
24      "ranking_page": "https://moz.com/domain-analysis",
25      "rank_position": 1,
26      "difficulty": 57,
27      "volume": 3300
28    },
29    {
30      "keyword": "check domain authority",
31      "ranking_page": "https://moz.com/domain-analysis",
32      "rank_position": 1,
33      "difficulty": 60,
34      "volume": 3300
35    }
36  ]
37}

Quota Usage

Uses one row per returned result.

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": "b4aaf902-b21e-40ce-8ccd-54e5bf03ad02",
  "method": "beta.data.site.ranking.keywords.list",
  "params": {
    "data": {
      "target_query": {
        "query": "moz.com",
        "scope": "domain",
        "locale": "en-US"
      }
    }
  }
}'