Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free.. Free Sign Up!

Competitors (competitors)

API v3 methods will be unavailable from 03/01/2022. Use a similar API v4 method.

The competitors 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

Response parameters
Parameter Description 
result Contains the answer
"domain.com" Domain-competitor that contains the answer
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 update
traff_dynamic Traffic change since the last update
ads_dynamic Change in the number of keywords used in PPC Ads
new_keywords The number of acquired keywords for the domain since the last update
out_keywords Number of keywords lost by a domain since the last update
rised_keywords Number of domain's keywords which positions have improved since the last update
down_keywords Number of domain's keywords which positions have dropped since the last update
ad_keywords Number of keywords used by domain in PPC Ads
ads Number of Ads
intersected Number of domain keywords which contain a target keyword
relevance Domain's relevance to the keyword
status_msg Response "OK" or "Error" report on a successful or unsuccessful request
status_code Response code "200" — successful request. Errors occur when credits are exceeded (number of simultaneous requests or account credits).
left_lines API credits remaining

Part of the API response for which you spend 1 credit:

{
"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,
    "visible_mysql": 0,
    "intersected": 829994,
    "relevance": 1.78,
    "our_relevance": 41.19
},

Example
Request data:

api.serpstat.com/v3/competitors?query=iphone&token=XXX&se=g_us

Response data:
{
    "result": {
        "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,
            "visible_mysql": 0,
            "intersected": 829994,
            "relevance": 1.78,
            "our_relevance": 41.19
        },
        "amazon.com": {
            "domain": "amazon.com",
            "visible": 18181.82345,
            "keywords": 186384810,
            "traff": 8394873616,
            "visible_dynamic": 248.7122100000015,
            "keywords_dynamic": 1095483,
            "traff_dynamic": 136774242,
            "ads_dynamic": 2196,
            "new_keywords": 1564684,
            "out_keywords": 469201,
            "rised_keywords": 3710865,
            "down_keywords": 2981229,
            "ad_keywords": 76535,
            "ads": 67995,
            "visible_mysql": 0,
            "intersected": 506654,
            "relevance": 0.27,
            "our_relevance": 25.14
        }
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 999255
}

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.

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

Open support chat