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