Сompetitors in organic search results
The SerpstatKeywordProcedure.getCompetitors method lists the domains that rank for the given keyword in Google top-20 results. The data set is similar to the Keyword research — SEO research — Competitors report.
General request parameters and instructions for using Serpstat API
Search databases available
Filter
| Request parameters | |||||
| Parameter | Description | Type | Optional | Default value | Value Options |
| id | A request id: the response contains the same id. Enter any number (number) or text (string) value | int/string | no | 1, test | |
| method | API method name | string | no | SerpstatKeywordProcedure.getCompetitors | |
| params | The object with parameters {...}, it lists all the following parameters and arrays [...] | array | no |
| |
| keyword | Keyword to search for | string | no | iphone | |
| se | ID of the search base to be searched. | string | no | g_us | |
| sort | Order of sorting the results in the format: {{{field}}: {{order}}} | array | yes | [ ] empty array | {"keyword": "desc"} or {"visible": "asc"} |
| size | Number of results per page in response | int | yes | 100 | "size": "10" |
| filters | Filter conditions | array | yes | "domain": www.apple.com "minus_domain": www.blackberry.com "visible": 30; "traff": 300; "relevance": 5; "our_relevance": 11 | |
| Response parameters | |
| Parameter | Description |
| id | Response id corresponds the request id |
| result | Contains the answer |
| data | Array with data |
| domain | Domain |
| visible | Domain's visibility |
| keywords | Number of keywords found in the chosen search engine |
| traff | Estimated search traffic based on keyword positions and search volume |
| visible_dynamic | Change in visibility since the last upgrade |
| keywords_dynamic | Change in the number of keywords since the last upgrade |
| traff_dynamic | Traffic change since the last upgrade |
| ads_dynamic | Keyword change in PPC Ads |
| new_keywords | Number of new keywords for the domain since the last upgrade |
| out_keywords | Number of keywords lost by a domain since the last upgrade |
| rised_keywords | Number of domain keywords which positions have improved since the last upgrade |
| down_keywords | Number of domain keywords which positions have dropped since the last upgrade |
| ad_keywords | Number of keywords in PPC |
| ads | Number of Ads |
| intersected | Number of domain keywords which contain a target keyword |
| relevance | Domain's relevance to the keyword |
| summary_info | Object with data |
| page | Page number |
| left_lines | Number of remaining API lines |
Credits: the number of charged credits corresponds to the number of results obtained upon request. You can get no more than 60000 results per a query. Part of the API response, for which 1 credit is charged:
{
"apple.com": {
"domain": "apple.com",
"visible": 3417.2564,
"keywords": 46650466,
"traff": 1998603882,
"visible_dynamic": 6.359480000000076,
"keywords_dynamic": -751,
"traff_dynamic": 7691041,
"ads_dynamic": -390,
"new_keywords": 153290,
"out_keywords": 154041,
"rised_keywords": 453556,
"down_keywords": 465903,
"ad_keywords": 5422,
"ads": 4018,
"intersected": 829984,
"relevance": 1.78,
"our_relevance": 9.97
},{
"id": "1",
"method": "SerpstatKeywordProcedure.getCompetitors",
"params": {
"keyword": "iphone",
"se": "g_us",
"sort": {"relevance":"desc"},
"size": "10"
}
}{
"id": "1",
"result": {
"data": {
"apple.com": {
"domain": "apple.com",
"visible": 3417.2564,
"keywords": 46650466,
"traff": 1998603882,
"visible_dynamic": 6.359480000000076,
"keywords_dynamic": -751,
"traff_dynamic": 7691041,
"ads_dynamic": -390,
"new_keywords": 153290,
"out_keywords": 154041,
"rised_keywords": 453556,
"down_keywords": 465903,
"ad_keywords": 5422,
"ads": 4018,
"intersected": 829984,
"relevance": 1.78,
"our_relevance": 9.97
},
"unsplash.com": {
"domain": "unsplash.com",
"visible": 529.99216,
"keywords": 3013535,
"traff": 269523447,
"visible_dynamic": 5.305380000000014,
"keywords_dynamic": 46438,
"traff_dynamic": 4015653,
"ads_dynamic": 0,
"new_keywords": 81673,
"out_keywords": 35235,
"rised_keywords": 104336,
"down_keywords": 75106,
"ad_keywords": 0,
"ads": 0,
"intersected": 18386,
"relevance": 0.61,
"our_relevance": 0.22
}
},
"summary_info": {
"page": 1,
"left_lines": 998658
}
}
}