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. | 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 | Page number |
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
}
}
}