Advertising report with specified name of domain (ad_keywords)
ad_keywords — method returns ads copies that pop up for the queried keyword in Google paid search results.
If you specify the name of the domain, the report lists all ads copies the domain is currently running.
If you specify the keyword, the report lists all ads copies the keyword is currently running.
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 |
position_from | min position for a keyword | 1-100 |
position_to | max position for a keyword | 1-100 |
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 |
right_spelling | filtering by misspelled keywords |
not_contains - contains misspelled keywords; contains - does not contain misspelled keywords |
To sort the results apply following parameters:
- sort : field that needs to be sorted
- order : sorting order (asc - ascending, desc - descending)
Metrics | Description |
result | Encapsulates the answer |
total | Number of paid search results for the keyword |
hits | Encapsulates the answer |
region_queries_count | Search volume in selected search engine database |
region_queries_count_wide | Search volume (broad match) |
region_queries_count_last | Search volume (last month) |
domain | Domain |
keyword_length | Number of words divided by space in a keyword |
keyword | Query for which an ad is displayed in SERP |
title | Ad Title |
url | Ad URL |
text | Ad text |
found_results | The number of results found for |
url_crc | CRC code (encryption method) for the "" |
CRC | The checksum for a quick search |
concurrency | Competition in AdWords |
position | Ad position |
keywords_id | Keyword ID in our database |
subdomain | Subdomain |
type | Ad placement type in relation to SERP (1. Above; 2. Under; 3. Side) |
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:
{
"keyword": "nike air force 1",
"keyword_length": 4,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/w/air-force-1-shoes-5sj3yzy7ok?cp=15839883195_search_%7Cnike+air+force+1%7CGOOGLE%7C71700000042134106%7CAll_X_X_X_X-Device_X_AF1-General_Exact%7Ce%7Cc&gclid=EAIaIQobChMIj6f9r4Sx5QIVR3ZgCh360Qx6EAAYASAAEgL9FPD_BwE&gclsrc=aw.ds",
"title": "Nike Air Force 1 | Nike Official Site",
"text": "Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear.",
"position": 1,
"type": 1,
"cost": 0.71,
"concurrency": 100,
"found_results": 69,
"region_queries_count": 90500,
"region_queries_count_wide": 0,
"region_queries_count_last": 0,
"types": [
"related_search",
"also_asks",
"ads_top",
"shopping_top"
],
"geo_names": [
],
"_id": "24829288_1"
}
Domain's ad keywords
api.serpstat.com/v3/ad_keywords?query=example.com&token=XXX&se=XXX
Keyword's ad keywords
api.serpstat.com/v3/ad_keywords?query=example.com&token=XXX&se=XXX
{
"result": {
"total": 4346,
"hits": [
{
"keyword": "new jordans",
"keyword_length": 2,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/launch/t/air-jordan-34-blue-void/?cp=38436339870_search_%7Cnew+jordan+shoes%7CGOOGLE%7C71700000041131813%7CAll_X_X_X_X-Device_X_Jordan34_Exact%7Ce%7Cc&gclid=EAIaIQobChMImObKip3G5QIVBttkCh36PACYEAAYASAAEgJUdfD_BwE&gclsrc=aw.ds",
"title": "Air Jordan XXXIV | The Newest Jordans",
"text": "One Of the Lightest Air Jordans To Date.",
"position": 1,
"type": 1,
"cost": 0.34,
"concurrency": 100,
"found_results": 2350000000,
"region_queries_count": 201000,
"region_queries_count_wide": 0,
"region_queries_count_last": 0,
"types": [
"ads_top",
"shopping_top",
"also_asks",
"video",
"related_search"
],
"geo_names": [
],
"_id": "14996_1"
},
{
"keyword": "nike air force 1",
"keyword_length": 4,
"domain": "nike.com",
"subdomain": "www.nike.com",
"url": "https://www.nike.com/w/air-force-1-shoes-5sj3yzy7ok?cp=15839883195_search_%7Cnike+air+force+1%7CGOOGLE%7C71700000042134106%7CAll_X_X_X_X-Device_X_AF1-General_Exact%7Ce%7Cc&gclid=EAIaIQobChMIj6f9r4Sx5QIVR3ZgCh360Qx6EAAYASAAEgL9FPD_BwE&gclsrc=aw.ds",
"title": "Nike Air Force 1 | Nike Official Site",
"text": "Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear.",
"position": 1,
"type": 1,
"cost": 0.71,
"concurrency": 100,
"found_results": 69,
"region_queries_count": 90500,
"region_queries_count_wide": 0,
"region_queries_count_last": 0,
"types": [
"related_search",
"also_asks",
"ads_top",
"shopping_top"
],
"geo_names": [
],
"_id": "24829288_1"
}
]
},
"status_msg": "OK",
"status_code": 200,
"left_lines": 947650
}
for the following request: http://api.serpstat.com/v3/ad_keywords?query=amazon.com&token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&se=g_us
{
"result":{
"total":1936389,
"hits":[
{
"region_queries_count":390,
"domain":"amazon.com",
"region_queries_count_wide":null,
"keyword":"samsung tv for sale",
"title":"Buy LCD TV\u200e",
"url":"http:\/\/www.amazon.com\/gp\/redirect.html?ie=UTF8&location=http%3A%2F%2Fwww.amazon.com%2Fs%3Fie%3DUTF8%26x%3D0%26ref%255F%3Dnb%255Fss%255F%26y%3D0%26field-keywords%3Dflat%2520panel%2520tv%26url%3Dsearch-alias%253Daps&tag=digginlifcomm-20&linkCode=ur2&camp=1789&creative=390957\"",
"text":"Samsung 50\" Plasma HDTV $1090Panasonic Viera 50\" 1080p HD $1900",
"found_results":"40900000",
"url_crc":-1969986727,
"crc":992182628,
"cost":1.74,
"concurrency":98,
"position":5,
"keyword_id":"5021223",
"subdomain":"www.jbhifi.co.nz",
"type":2,
"types":[
],
"geo_names":[
]
},
{
"region_queries_count":40,
"domain":"amazon.com",
"region_queries_count_wide":null,
"keyword":"flat tube tv",
"title":"Flat Screen TV\u200e",
"url":"http:\/\/www.amazon.com\/gp\/redirect.html?ie=UTF8&location=http%3A%2F%2Fwww.amazon.com%2Fs%3Fie%3DUTF8%26x%3D0%26ref%255F%3Dnb%255Fss%255F%26y%3D0%26field-keywords%3Dflat%2520panel%2520tv%26url%3Dsearch-alias%253Daps&tag=digginlifcomm-20&linkCode=ur2&camp=1789&creative=390957\"",
"text":"Samsung 50\" Plasma HDTV $1090Panasonic Viera 50\" 1080p HD $1900",
"found_results":"97200000",
"url_crc":-1969986727,
"crc":100335124,
"cost":0.65,
"concurrency":82,
"position":6,
"keyword_id":"5021294",
"subdomain":"www.thesimpletvstandstore.com",
"type":2,
"types":[
"pic"
],
"geo_names":[
]
},
{
"region_queries_count":50,
"domain":"amazon.com",
"region_queries_count_wide":null,
"keyword":"wildwood hotel deals",
"title":"Amazon Destinations - amazon.com\u200e",
"url":"http:\/\/local.amazon.com\/travel\/new-jersey-shore?ref_=ps_goog_tr_ne_nj_acc_014",
"text":"Ideal Hotels for Your Local Getaway Near Wildwood. Book Today!",
"found_results":"209000",
"url_crc":-1478258950,
"crc":1422539021,
"cost":1.61,
"concurrency":90,
"position":2,
"keyword_id":"5008992",
"subdomain":"www.maplandia.com",
"type":1,
"types":[
"map"
],
"geo_names":[
]
},
{
"region_queries_count":10,
"domain":"amazon.com",
"region_queries_count_wide":null,
"keyword":"keyboard for laptop online",
"title":"HP ELiteBook 850 $789\u200e",
"url":"http:\/\/www.amazon.com\/HP-G2S67UP-ELITEBOOK-I5-4300U-15-6IN\/dp\/B00R96K89G\/ref=aag_m_pw_dp?ie=UTF8&m=AWJJ3QFFNGDJT",
"text":"Intel i5 1.9Ghz 8GB 256GB SSD WIN7PBrand new in box Ships out same day",
"found_results":"23800000",
"url_crc":-295021003,
"crc":2002263495,
"cost":0.26,
"concurrency":100,
"position":3,
"keyword_id":"5011386",
"subdomain":"www.posturite.co.uk",
"type":2,
"types":[
],
"geo_names":[
]
},
<?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',
];
$keywords = 'keywords';
// 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\AdKeywordsMethod(
$keywords,
\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 = 'ad_keywords'
params = {
'query': 'example.com', # 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)"