Common and Unique Keywords (domains_uniq_keywords)

domains_uniq_keywords — method returns unique keywords of a domain. Keywords that queried domain has in common with one or two other domains are removed from the list.

Pagination

Following parameters can be used for pagination:

page_size : number of results per page (default: 100, max: 1000)
page : page number (set to the 1st page by default

You can use the following parameters to filter the results

Parameter	Description	Possible settings
queries_from	min number of monthly searches	0-100,000,000
queries_to	max number of monthly searches	0-100,000,000
cost_from	min CPC	0-200
cost_to	max CPC	0-200
concurrency_from	min level of competition	1-100
concurrency_to	max level of competition	1-100

Metrics	Description
result	Encapsulates the answer
total	Number of keywords for which the domain ranks in top-100
region_queries_count	Search volume in selected search engine database
domain	Domain
keyword_length	Number of words divided by space in a keyword
keyword	Keyword for which the domain ranks
url	URL of a page which appears in SERP for the keyword
dynamic	How the position of this keyword has changed
traff	Approximate organic traffic prognosis
keyword_crc	The checksum for a quick search
found_results	The number of results found for "keywords"
url_crc	CRC code (encryption method) for the ""url"" variable
cost	Cost per click, $
concurrency	Keyword competition in PPC (0-100)
position	Domain's position for a keyword
keyword_id	Keyword ID in our database
subdomain	Subdomain which ranks for the keyword
region_queries_count_wide	Search volume (broad match)
types	A list of special elements shown in SERP (for example, video, carousel or map)
geo_names	List of toponyms in the array (if toponyms are present in the keywords)
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

Part of the API response, for which 1 limit is charged:

{
"domain": "example.com",
"subdomain": null,
"keyword": "use somebody",
"keyword_length": 2,
"url": "https://example.com/",
"position": 16,
"types": [
"related_search",
"video",
"pic",
"refine_by_brand"
],
"found_results": 90,
"cost": 0,
"concurrency": 0,
"region_queries_count": 10,
"region_queries_count_wide": 0,
"geo_names": [],
"traff": 0,
"dynamic": null,
"_id": "92473146-76",
"google.com": 30,
"example.com": 56
}

Example PHP Python

Request data:

api.serpstat.com/v3/domains_uniq_keywords?query=domain1,domain2&minus_domain=domain3&se=XXX&token=XXX

Response data:

{
  "result": {
    "total": -2570894,
    "hits": [
      {
        "domain": "example.com",
        "subdomain": null,
        "keyword": "use somebody перевод на русский",
        "keyword_length": 5,
        "url": "https://example.com/",
        "position": 76,
        "types": [
          "related_search",
          "video",
          "pic",
          "refine_by_brand"
        ],
        "found_results": 93,
        "cost": 0,
        "concurrency": 0,
        "region_queries_count": 1,
        "region_queries_count_wide": 0,
        "geo_names": [],
        "traff": 0,
        "dynamic": null,
        "_id": "92473146-76",
        "google.com": 34,
        "example.com": 76
      },
        {
        "domain": "example.com",
        "subdomain": null,
        "keyword": "use somebody",
        "keyword_length": 2,
        "url": "https://example.com/",
        "position": 16,
        "types": [
          "related_search",
          "video",
          "pic",
          "refine_by_brand"
        ],
        "found_results": 90,
        "cost": 0,
        "concurrency": 0,
        "region_queries_count": 10,
        "region_queries_count_wide": 0,
        "geo_names": [],
        "traff": 0,
        "dynamic": null,
        "_id": "92473146-76",
        "google.com": 30,
        "example.com": 56
      }
    ]
  },
  "status_msg": "OK",
  "status_code": 200,
  "left_lines": 344691
}

<?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',
];
$domains = ['example.com','example1.com'];
$excludeDomains = ['example2.com'];
// 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\DomainsUniqKeywordsMethod(
    $domains,
    $excludeDomains,
    \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 = 'domains_uniq_keywords'

params = {
    'query': ','.join(['example1.com', 'example2.com']),
    'minus_domain': 'example3.com',
    'se': 'g_us',
    'token': 'ijmiom4f5m34905g03um8342dm04923lre3w'}

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

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)"