Some options are limited.

This site uses cookies and other tracking technologies to make possible your usage of the website, assist with navigation and your ability to provide feedback, analyse your use of our products and services, assist with our promotional and marketing efforts, and provide better user experience.

By using the website, you agree to our Privacy policy

Accept and continue

Advertising report with specified name of domain (ad_keywords)

ad_keywords

This report shows you 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.

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

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



Example PHP Python
Request data:
Response data:
{  
   "result":{  
      "total":3109,
      "hits":[  
         {  
            "region_queries_count":49500,
            "domain":"example.com",
            "region_queries_count_wide":null,
            "keyword_length":2,
            "keyword":"iphone 6s",
            "title":"example",
            "url":"http:\/\/example",
            "text":"\example",
            "found_results":"51100000",
            "url_crc":-1839016631,
            "CRC ":458484575,
            "cost":0.23,
            "concurrency":64,
            "position":1,
            "date":"2017-04-13",
            "keyword_id":10453084,
            "subdomain":null,
            "type":3,
            "region_queries_count_last":27100,
            "types":[  

            ],
            "geo_names":[  

            ]
   }
   },
   "status_msg":"OK",
   "status_code":200,
   "left_lines":998590
}

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

 

Sign In Free Sign Up

You’ve reached your query limit.

Or email
Forgot password?
Or email
Back To Login

Don’t worry! Just fill in your email and we’ll send over your password.

Are you sure?
Please pick the project to work on

Personal demonstration

Serpstat is all about saving time, and we want to save yours! One of our specialists will contact you and discuss options going forward.

These may include a personal demonstration, a trial period, comprehensive training articles & webinar recordings, and custom advice from a Serpstat specialist. It is our goal to make you feel comfortable while using Serpstat.

Name
Email
Phone
We are glad of your comment

Upgrade your plan

Upgrade your plan

Export is not available for your account. Please upgrade to Plan A or higher to get access to the tool. Learn more

Sign Up Free

Спасибо, мы с вами свяжемся в ближайшее время

Invite
E-mail
Message
Optional

You have run out of limits

You have reached the limit for the number of created projects. You cannot create new projects unless you increase the limits or delete existing projects.

I want more limits

Christmas is a time for miracles.

You are almost on the finish line of our Christmas quest. The last brick of your lego-promocode is left on the way up 55% discount.

Did not find previous lego-bricks? Fill the form anyway.

Name
Email
Phone