С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}}}

field — field to sort by:
* visible
* keywords
* traff
* visible_dynamic
* keywords_dynamic
* traff_dynamic
* ads_dynamic
* new_keywords
* out_keywords
* rised_keywords
* down_keywords
* ad_keywords
* ads
* intersected
* relevance
* our_relevance

order — sort direction (asc — ascending, desc — descending)

array

yes

 [ ] empty array

{"keyword": "desc"} 

or

{"visible": "asc"}

size

Number of results per page in response

int

yes

100

"size": "10"

min: 1, max: 1000

filters

Filter conditions

array

yes

"domain": www.apple.com

"minus_domain": www.blackberry.com

"visible": 30;
"visible_from": 20;
"visible_to": 100

"traff": 300;
"traff": 500;
"traff": 1000

"relevance": 5;
"relevance_from": 25;
"relevance_to": 30

"our_relevance": 11
"our_relevance_from": 25;
"our_relevance_to": 30

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
},

Example
Request data:
{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getCompetitors",
 "params": {
   "keyword": "iphone",
   "se": "g_us",
   "sort": {"relevance":"desc"},
   "size": "10"
 }
}
Response data:
{
    "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
        }
    }
}

Share this article with your friends

Are you sure?

Introducing Serpstat

Find out about the main features of the service in a convenient way for you!

Please send a request, and our specialist will offer you education options: a personal demonstration, a trial period, or materials for self-study and increasing expertise — everything for a comfortable start to work with Serpstat.

Name

Email

Phone

We are glad of your comment
I agree to Serpstat`s Privacy Policy.

Thank you, we have saved your new mailing settings.

Open support chat