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 ""keyword""
url_crc	CRC code (encryption method) for the ""url"" variable
CRC	The checksum for a quick search
cost	Cost per click, $
concurrency	Competition in AdWords
position	Ad position
date	Date of an ad update
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"
}

Example PHP Python

Request data:

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

Response data:

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