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 | Type | Required | Default value | Value options |
| id | A request id: the response contains the same id. Enter any number (number) or text (string) value | int/string | yes | 1, test | |
| method | API method name | string | yes |
| SerpstatDomainProcedure. |
| params | The object with parameters {...}, it lists all the following parameters and arrays [...] | array | yes |
|
|
| domain | Domain name | string | yes |
| nike.com |
| se | ID of the search base to be searched. | string | yes |
| g_us |
| withSubdomains | Search type: with/without subdomains | string | no | true | true | false |
| url | Link to refine your search | string | no |
| https://www.nike.com/soccer |
| keywords | Array of keywords to search for | string | no |
| ["shop", "nike"] |
| minusKeywords | Negative keyword array | string | no |
| ["nikes", "nke"] |
| filters | Filter conditions | array | no | no filtration | filter conditions are listed in the next table |
| sort | Sort by data (ascending and descending) | array | no | {"position": "asc", "region_queries_count": "desc"} | "region_queries_count": "asc"/"desc" (asc — ascending sort direction, desc — descending) - Keyword search volume |
| page | Page number in response | int | no | 1 | "page": "5" |
| size | Number of results per page in response | int | no | 100 | "size": "10" min: 1, max: 1000 |
| Filter conditions parameters | |||
| Parameter | Description | Type | Value Options |
| cost | Cost per click (in US $; exact match) | float | any number value |
| cost_from | Cost per click (in US $; exact match) from | float | any number value |
| cost_to | Cost per click (in US $; exact match) to | float | any number value |
| position | Keyword position | int | any whole number in the range of 1-100 |
| position_from | Keyword position from | int | any whole number in the range of 1-100 |
| position_to | Keyword position to | int | any whole number in the range of 1-100 |
| concurrency | Competition (how hard is it to promote a keyword to the top from 1-100) | int | any whole number in the range of 1-100 |
| concurrency_from | Competition (how hard is it to promote a keyword to the top from 1-100) from | int | any whole number in the range of 1-100 |
| concurrency_to | Competition (how hard is it to promote a keyword to the top from 1-100) to | int | any whole number in the range of 1-100 |
| keyword_length | Number of words in the keyword | int | any number value |
| difficulty | The difficulty of the keyword | float | any number value |
| difficulty_from | The difficulty of the keyword from | float | any number value |
| difficulty_to | The difficulty of the keyword to | float | any number value |
| traff | Traffic by the keyword | int | any whole number |
| region_queries_count | Volume of the keyword by the selected region | int | any whole number |
| region_queries_count_from | Volume of the keyword by the selected region from | int | any whole number |
| region_queries_count_to | Volume of the keyword by the selected region to | int | any whole number |
| region_queries_count_wide | Volume of the keyword in broad match | int | any whole number |
| region_queries_count_wide_from | Volume of the keyword in broad match from | int | any whole number |
| region_queries_count_wide_to | Volume of the keyword in broad match to | int | any whole number |
| url_contains | The exact website pages ranking for the keywords | string | any text value |
| right_spelling | Display or not to display misspelled keywords | boolean | true or false |
| keyword_contain | Contains all keywords(exact matching) | string | any text value |
| keyword_not_contain | Does not contain all keywords (exact matching) | string | any text value |
| keyword_contain_one_of | Contains one of the keywords (exact matching) | string | any text value |
| keyword_not_contain_one_of | Does not contain one of the keywords (exact matching) | string | any text value |
| keyword_contain_broad_match | Contains all keywords (broad match) | string | any text value |
| keyword_not_contain_broad_match | Does not contain all keywords (broad match) | string | any text value |
| keyword_contain_one_of_broad_match | Contains one of the keywords (broad match) | string | any text value |
| keyword_not_contain_one_of_broad_match | Does not contain one of the keywords (broad match) | string | any text value |
| 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": [
{
"region_queries_count": 10,
"types": [
"related_search",
"also_asks",
"snip_breadcrumbs",
"snip_info"
],
"cost": 0,
"keyword_length": 3,
"url": "https://www.nike.com/soccer",
"concurrency": 0,
"geo_names": [],
"traff": 1,
"region_queries_count_wide": 0,
"domain": "nike.com",
"subdomain": "www.nike.com",
"dynamic": null,
"position": 1,
"keyword": "nike futbol 2019",
"found_results": 40700000,
"difficulty": 45.91084858865631
},
{
"domain": "nike.com",
"subdomain": "www.nike.com",
"keyword": "www nike soccer",
"keyword_length": 3,
"url": "https://www.nike.com/soccer",
"position": 1,
"types": [
"carousel",
"pic",
"snippet_breadcrumbs"
],
"found_results": 72,
"cost": 0,
"concurrency": 0,
"region_queries_count": 10,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 1,
"difficulty": 32.55082326680605,
"dynamic": 0
}
],
"summary_info": {
"page": 1,
"total": 1704,
"left_lines": 999014
}
}
}Serpstat API request drafts: link