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 |
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 "" |
concurrency | Keyword competition in PPC (0-100) |
position | Domain's position for a keyword |
keyword_id | Keyword ID in our database |
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
}
{
"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)"