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

url_competitors

Shows the list of URLs that compete with a queried URL in organic search.

Metrics	Description
result	Encapsulates the answer
total	Number of keywords for which URL ranks in top-10
cnt	Number of keywords for which URL ranks in top-10
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 limits are exceeded (number of simultaneous requests or account limits)
left_lines	Number of remaining API queries

Example PHP Python

Request data:

api.serpstat.com/v3/url_competitors?query=http://example.com/page.html&se=XXX&token=XXX

Response data:

"{  
   ""result"":{  
      ""total"":263,
      ""hits"":[  
         {  
            ""cnt"":36,
            ""domain"":""example.com"",
            ""url"":""http:\/\/example.com\/example.html""
         },
         {  
            ""cnt"":29,
            ""domain"":""example.com"",
            ""url"":""http:\/\/example.com\/""
         },.............. },
   ""status_msg"":""OK"",
   ""status_code"":200,
   ""left_lines"":998489
}"

<?php
// This example works on serpstat-sdk only
// https://github.com/SerpstatGlobal/serpstat-sdk

require_once __DIR__ . '/../vendor/autoload.php';
// configure your application
$config = [
    'token' => '19666fc1ae1724da1d5ea2f3a99d5f5a',
];
$url = 'http://example.com/page1/';
// init client with your serpstat api token
$apiClient = new \Serpstat\Sdk\Core\ApiGuzzleHttpClient($config['token']);
// create instance of any api method class
// list of methods classes in folder src\Methods
$apiMethod = new \Serpstat\Sdk\Methods\UrlCompetitorsMethod(
    $url,
    \Serpstat\Sdk\Interfaces\IApiClient::SE_GOOGLE_RU
);
try {
    // try call api method
    $response = $apiClient->call($apiMethod);
} catch (\Exception $e) {
    // catch api error
    $response = $e->getMessage();
}

import codecs
import json
import pprint
import urllib.request as urlrequest
from urllib.parse import urlencode

host = 'http://api.serpstat.com/v3'

method = 'url_competitors'
params = {
    'query': 'http%3A%2F%2Fwww.amazon.com%2FWinter-Is-Coming%2Fdp%2FB007HJ84ZK',  # string for get info
    'se': 'g_us',  # string search engine
    'token': 'ijmiom4f5m34905g03um8342dm04923lre3w',  # string personal token
}

api_url = "{host}/{method}?{params}".format(
    host=host,
    method=method,
    params=urlencode(params)
)

try:
    json_data = urlrequest.urlopen(api_url).read()
except Exception as e0:
    print("API request error: {error}".format(error=e0))

data = json.loads(json_data)
pprint.pprint(data)