Domain keywords
The SerpstatDomainProcedure.getDomainKeywords method keywords which the analyzed domain ranks for in Google top-100 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. | 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
}
}
}
Serpstat API request drafts: link