Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free..
Sign in Sign Up

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

Top keywords by domain V4 (SerpstatDomainProcedure.getDomainKeywords)

The SerpstatDomainProcedure.getDomainKeywords method keywords which the analyzed domain ranks for in Google top-100 or Yandex top-50 search results. The data set is similar to the Domain analysis — SEO research  Keywords report. You can get up to 60 000 results in this report.

General request parameters and instructions for using Serpstat API

Search databases available

Request parameters

Parameter

Description

Optional

Default value

Value options

id A request id: the response contains the same id. Enter any number (number) or text (string) value no 1, test

method

API method name

no

SerpstatDomainProcedure.
getDomainKeywords

params

The object with parameters {...}, it lists all the following parameters and arrays [...]

no

domain

Domain name

no

 

nike.com

se

ID of the search base to be searched (there are both Google and Yandex databases available, for example: g_us or y_157)

no

 

g_us

url

Link to refine your search

yes

null

https://www.nike.com/soccer

keywords

Array of keywords to search for

yes

[]

["shop", "nike"]

minusKeywords

Negative keyword array

yes

[]

["nikes", "nke"]

filters

Filter conditions

yes

{"concurrency_from": "0",
"concurrency_to": "1"}

{"right_spelling": true}

sort

Order of sorting the results in the format: {{{field}}: {{order}}}

field — field to sort by:
* region_queries_count
* types
* cost
* keyword_length
* concurrency
* geo_names
* traff
* region_queries_count_wide
* dynamic
* position
* found_results

order — sort direction (asc — ascending, desc — descending)

yes

{"position": "asc", "region_queries_count":"desc"}

{"cost": "asc"}

page

Page number in response

yes

1

"page": "5"

size

Number of results per page in response

yes

100

"size": "10"

min: 1, max: 1000

To filter the results use the following parameters:

Parameter Description Possible value
position_from min position for a keyword  1-100
position_to max position for a keyword  1-100
queries_from min number of monthly searches  0-100,000,000
queries_to max number of monthly searches  0-100,000,000
cost_from min CPC  0-200
cost_to max CPC  0-200
concurrency_from min competition value  1-100
concurrency_to max competition value  1-100

Response parameters

Parameter

Description

id

Response id corresponds the request id

result

Contains the answer

data

Array with data

domain

Analyzed domain

subdomain

Subdomain appeared in search results for a given keyword

keyword

Keyword which the domain ranks for

keyword_length

Number of words divided by space in a keyword

url URL appeared in the search result for the query
position Domain's position for a keyword
types List of special elements shown in SERP (for example, video, carousel or map)
found_results Number of results found for the keyword
cost Cost per click, $

concurrency

Keyword competition in the PPC (0-100%)

region_queries_count Search volume in a selected region
region_queries_count_wide Search volume in selected search engine database in broad match

geo_names

List of toponyms in the array (if toponyms are present in the keywords)

traff

Approximate traffic by keyword depending on its volume and position

difficulty

The assessment of the level of competition for a keyword to advance in organic search in the top-10 (from 0 to 100%)

right_spelling

Recommended correction of a misspelled keyword

dynamic Position change for the keyword
summary_info Object with data
page Page number
total Number of keywords which the domain ranks for in top of search results

left_lines

API credits remaining

Part of the API response, for which 1 credit is charged:

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "nike socer",
    "keyword_length": 2,
    "url": "https://www.nike.com/soccer",
    "position": 1,
    "types": [
        "shopping_rhs",
        "ads_top",
        "snip_breadcrumbs"
    ],
    "found_results": 90,
    "cost": 0.48,
    "concurrency": 100,
    "region_queries_count": 9900,
    "region_queries_count_wide": 0,
    "geo_names": [],
    "traff": 1484,
    "difficulty": 20.35,
    "right_spelling": "nike soccer",
    "dynamic": 0
},

Example
Request data:
{
 "id": "1",
 "method": "SerpstatDomainProcedure.getDomainKeywords",
 "params": {
   "domain": "nike.com",
   "se": "g_us",
   "sort": { "position": "asc"},
   "url": "https://www.nike.com/soccer",
   "keywords": ["shop", "nike"],
   "minusKeywords": ["nikes", "nke"],
   "filters": { "queries_from": "1000", "queries_to": "10000"},
   "page": "1",
   "size": "10"
 }
}

Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "nike socer",
                "keyword_length": 2,
                "url": "https://www.nike.com/soccer",
                "position": 1,
                "types": [
                    "shopping_rhs",
                    "ads_top",
                    "snip_breadcrumbs"
                ],
                "found_results": 90,
                "cost": 0.48,
                "concurrency": 100,
                "region_queries_count": 9900,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 1484,
                "difficulty": 20.35,
                "right_spelling": "nike soccer",
                "dynamic": 0
            },
            {
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "keyword": "nike spccer",
                "keyword_length": 2,
                "url": "https://www.nike.com/soccer",
                "position": 1,
                "types": [
                    "snip_breadcrumbs"
                ],
                "found_results": 99,
                "cost": 0.48,
                "concurrency": 100,
                "region_queries_count": 9900,
                "region_queries_count_wide": 0,
                "geo_names": [],
                "traff": 1484,
                "difficulty": null,
                "right_spelling": "nike soccer",
                "dynamic": 0
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 77,
            "left_lines": 997219
        }
    }
}