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. |
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
},
{
"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
}
}
}
{
"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
}
}
}