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

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

List of URLs that compete with a queried page (url_competitors)

The url_competitors method returns the list of URL competitors to the queried URL. The data set is similar to the Competitors report in the URL analysis.

General request parameters and instructions for using Serpstat API

Response parameters
Parameter Description
result Contains the answer
total Number of keywords for which URL ranks in top-10
hits Contains the answer
cnt Number of keywords in the top 10 for which pages intersect
domain Competitor's domain
url Competitor's URL
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:

{
    "cnt": 230,
    "domain": "nike.com",
    "url": "https://www.nike.com/w/mens-shoes-nik1zy7ok",
    "url_crc": -1410140829
},

Example Python
Request data:

api.serpstat.com/v3/url_competitors?query=https://nike.com/men&token=XXX&se=g_us

Response data:
{
    "result": {
        "total": 354,
        "hits": [
            {
                "cnt": 230,
                "domain": "nike.com",
                "url": "https://www.nike.com/w/mens-shoes-nik1zy7ok",
                "url_crc": -1410140829
            },
            {
                "cnt": 190,
                "domain": "nike.com",
                "url": "https://www.nike.com/",
                "url_crc": 855213616
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 998579
}