DataSiteRankingKeywordList

Search API documentation

⌘K

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:

data.site.ranking-keyword.list

Go to Example Code

Request

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

Control the number of results returned per call in addition to fetching additional results. The default "limit" is 25 with an "n" value of 0 (indicating the first page of results). Make subsequent calls to the endpoint with incrementing "n" values to fetch additional pages of results.

Response

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.

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

Example Code

Quota Usage

Uses one row per returned result.

api.limits.data.rows