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" min: 1, max: 1000
filters	Filter conditions	yes	true;false	"right_spelling": true "right_spelling": false "misspelled": false "cost": 15 "cost_from": 10 "cost_to": 50 "concurrency": 50 "concurrency_from": 10 "concurrency_to": 100 "difficulty": 3 "difficulty_from": 10 "difficulty_to": 15 "region_queries_count": 10000 "region_queries_count_from": 1000 "region_queries_count_to": 5000 "region_queries_count_wide": 10000 "region_queries_count_wide_from": 1000 "region_queries_count_wide_to": 5000 "keyword_length": 1 "keyword_length_from": 1 "keyword_length_to": 3 "traff": 3000 "traff_from": 1000 "traff_to": 5000 "position": 1 "position_from": 5 "position_to": 20 "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
},

Example

Request data:

{
 "id": "1",
 "method": "SerpstatDomainProcedure.getDomainsIntersection",
 "params": {
     "se": "g_us",
     "domains": ["nike.com", "adidas.com", "puma.com"],
     "page": "1",
     "size": "10"
 }
}

Response data:

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