Domain keywords

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
withSubdomains	Search type: with/without subdomains	yes	true	true \| false
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		{"right_spelling": true} {"right_spelling": false} {"position_dynamic": "new"} {"position_dynamic": "rise"} {"position_dynamic": "down"}
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

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 PHP Python

Request data:

{
    "id": "1",
    "method": "SerpstatDomainProcedure.getDomainKeywords",
    "params": {
        "domain": "nike.com",
        "se": "g_us",
        "withSubdomains": true,
        "sort": {
            "position": "asc"
        },
        "url": "https://www.nike.com/soccer",
        "keywords": [
            "shop",
            "nike"
        ],
        "minusKeywords": [
            "nikes",
            "nke"
        ],
        "page": "1",
        "size": "10",
        "filters": {
            "right_spelling": false
        }
    }
}

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
        }
    }
}