Domain vs Domain
The SerpstatDomainProcedure.getDomainsIntersection method returns common keywords of up to 3 domains. The data set is similar to the Domain vs domain 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.getDomainsIntersection |
params |
The object with parameters {...}, it lists all the following parameters and arrays [...] |
no |
|
|
domains |
Array of domains (min2, max3) |
no |
- |
["starbucks.com", "apple.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 |
page |
Page number in response |
yes |
1 |
"page": "5" |
size |
Number of results per page in response |
yes |
100 |
"size": "10" |
filters |
Filter conditions |
yes |
true;false |
"right_spelling": true "misspelled": false "cost": 15 "concurrency": 50 "difficulty": 3 "region_queries_count": 10000 "region_queries_count_wide": 10000 "keyword_length": 1 "traff": 3000 "position": 1 "keywords": [ "iphone", "iphone x"] "minus_keywords": [ "ipad", "iphone xr"]
|
Response parameters | |
Parameter |
Description |
id |
Response id corresponds the request id |
result |
Contains the answer |
data | Array with data |
region_queries_count |
Search volume in selected region |
types |
List of special elements shown in SERP (for example, video, carousel or map) |
cost |
Cost per click, $ |
keyword_length |
Number of words divided by space in a keyword |
concurrency |
Keyword competition in the PPC (0-100%) |
geo_names |
List of toponyms in the array (if toponyms are present in the keywords) |
traff |
Estimated search traffic based on keyword positions and search volume |
region_queries_count_wide |
Search volume (broad match) |
keyword |
Keyword ranking the given website |
found_results |
Number of results found for the keyword |
domain 1,2,3 | Domain which ranks for the keyword (1,2,3) |
subdomain 1,2,3 | Subdomain which ranks for the keyword (1,2,3) |
url 1,2,3 | URL of a page which appears in SERP for the keyword (1,2,3) |
position 1,2,3 | Positions of the compared domains for a given keyword (1,2,3) |
dynamic 1,2,3 | How the position of the domain (1,2,3) by this keyword has changed |
summary_info | Object with data |
page | Номер страницы |
total | Number of found common keywords |
left_lines | API credits remaining |
Credits: the number of charged credits corresponds to the number of results obtained upon request.
Part of the API response, for which 1 credit is charged:
{
"region_queries_count": 1,
"types": [
"video",
"related_search",
"also_asks",
"snip_breadcrumbs"
],
"cost": 0,
"keyword_length": 6,
"concurrency": 0,
"geo_names": [],
"traff": 0,
"region_queries_count_wide": 0,
"keyword": "shoes youth size 8 on sale",
"found_results": 688000000,
"domain3": "puma.com",
"subdomain3": "us.puma.com",
"url3": "https://us.puma.com/en/us/kids",
"position3": 35,
"dynamic3": -17,
"domain1": "nike.com",
"subdomain1": "www.nike.com",
"url1": "https://www.nike.com/w/boys-sale-shoes-1onraz3yaepzy7ok",
"position1": 18,
"dynamic1": null,
"domain2": "adidas.com",
"subdomain2": "www.adidas.com",
"url2": "https://www.adidas.com/us/kids-youth-shoes",
"position2": 28,
"dynamic2": -10
},
{
"id": "1",
"method": "SerpstatDomainProcedure.getDomainsIntersection",
"params": {
"se": "g_us",
"domains": ["nike.com", "adidas.com", "puma.com"],
"page": "1",
"size": "10"
}
}
{
"id": "1",
"result": {
"data": [
{
"region_queries_count": 1,
"types": [
"video",
"related_search",
"also_asks",
"snip_breadcrumbs"
],
"cost": 0,
"keyword_length": 6,
"concurrency": 0,
"geo_names": [],
"traff": 0,
"region_queries_count_wide": 0,
"keyword": "shoes youth size 8 on sale",
"found_results": 688000000,
"domain3": "puma.com",
"subdomain3": "us.puma.com",
"url3": "https://us.puma.com/en/us/kids",
"position3": 35,
"dynamic3": -17,
"domain1": "nike.com",
"subdomain1": "www.nike.com",
"url1": "https://www.nike.com/w/boys-sale-shoes-1onraz3yaepzy7ok",
"position1": 18,
"dynamic1": null,
"domain2": "adidas.com",
"subdomain2": "www.adidas.com",
"url2": "https://www.adidas.com/us/kids-youth-shoes",
"position2": 28,
"dynamic2": -10
},
{
"region_queries_count": 10,
"types": [
"pic",
"related_search",
"video"
],
"cost": 0,
"keyword_length": 4,
"concurrency": 57,
"geo_names": [],
"traff": 0,
"region_queries_count_wide": 0,
"keyword": "nike sock guard shoes",
"found_results": 77,
"difficulty": 6.842005366680182,
"domain3": "puma.com",
"subdomain3": "us.puma.com",
"url3": "https://us.puma.com/en/us/mens/shoes",
"position3": 52,
"dynamic3": -51,
"domain1": "nike.com",
"subdomain1": "store.nike.com",
"url1": "https://store.nike.com/us/en_us/pw/shin-guards/ofb",
"position1": 1,
"dynamic1": 0,
"domain2": "adidas.com",
"subdomain2": "www.adidas.com",
"url2": "https://www.adidas.com/us/leo_messi",
"position2": 51,
"dynamic2": -50
}
],
"summary_info": {
"page": 1,
"total": 179918,
"left_lines": 999949
}
}
}