Domain ads

The SerpstatDomainProcedure.getAdKeywords method returns paid keywords and ads copies that pop up for the queried domain in paid search results. The data set is similar to the Domain analysis  PPC research  Keywords report. 

General request parameters and instructions for using Serpstat API

Search databases available

Request parameters

Parameter

Value

Optional

Default value

Value Options

id

A request id: the response contains the same id. Enter any number (number) or text (string) value

no

1, test

method

API method name

no

SerpstatDomainProcedure.getAdKeywords

params

The object with parameters {...}, it lists all the following parameters and arrays [...]

no

domain

Domain name

no

nike.com

se

ID of the search base to be searched.

no

g_us

url

Link to refine your search

yes

 

https://www.nike.com/nike-by-you

keywords

Array of keywords to search for

yes

[]

["nike", "id"]

minusKeywords

Negative keyword array

yes

[]

["nikeid"]

filters

Filter conditions

yes

 

{ "concurrency_from": "0", "concurrency_to": "1" }

sort

Order of sorting the results in the format:
{{{field}}: {{order}}}

field - field to sort by:
keyword_length
position
type
cost
concurrency
found_results
region_queries_count
region_queries_count_wide
types
difficulty
geo_names

order - sort direction (asc - ascending, desc - descending)

yes

{"position": "asc", "region_queries_count":"desc"}

{"cost": "asc"}

page

Page number in response

yes

1

"page": "1"

size

Number of results per page in response

yes

100

"size": "50"

min: 1, max: 1000

filters

Filter conditions

yes

"position": 1
"position_from": 2
"position_to": 10

"queries": 5;
"queries_from": 7;
"queries_to": 10

"region_queries_count": "1000";
"region_queries_count_to": "2000";
"region_queries_count_from": 300

"region_queries_count_wide": "1000";
"region_queries_count_wide_to": "1500";
"region_queries_count_wide_from": 100

"cost": "10";
"cost_to": "10";
"cost_from": 1

"concurrency": "7";
"concurrency_to": "7";
"concurrency_from": 1

"difficulty": 3;
"difficulty_from": 5;
"difficulty_to": 10

"minus_url": https://www.apple.com/airpods-2nd-generation/

"pm_url": https://www.apple.com/airpods/

"right_spelling": true$ "right_spelling": false

"misspelled": true$ "misspelled": false

Response parameters

Parameter

Description

id

Response id corresponds the request id

result

Contains the answer

data

Array with data

keyword Keyword the analyzed domain bids on in Google Ads
keyword_length Number of words divided by space in a keyword
domain Analyzed domain
subdomain Subdomain of the analyzed domain
url URL where the ad leads
title Ad Title
text Ad text
position Ad position
type Ad placement type in relation to SERP (1 - above; 2 - under; 3 - side)
cost Cost per click, $
concurrency Competition in Google Ads (0-100%)
found_results Number of results found for the keyword

region_queries_count

Search volume in selected search engine database

region_queries_count_wide

Search volume (broad match)

types

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)

difficulty

The assessment of the level of competition for a keyword to advance in organic search in the top-10 (from 0 to 100%)

summary_info

Object with data

page Page number

total

Number of found results

left_lines

API credits remaining

Credits: the number of charged credits corresponds to the number of results obtained upon request. Part of the API response, for which 1 credit is charged:

{
    "keyword": "customize id nike",
    "keyword_length": 3,
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "url": "https://www.nike.com/nike-by-you",
    "title": "Custom Nike Shoes - Nike By You Shoe Customizer",
    "text": "Pick From Your Favorite Nike Styles & Color Them To Reflect Your Unique Personality.",
    "position": 1,
    "type": "1",
    "cost": 2.54,
    "concurrency": 59,
    "found_results": 24800000,
    "region_queries_count": 320,
    "region_queries_count_wide": 0,
    "types": [
        "ads_top",
        "also_asks"
        ],
    "geo_names": [],
    "difficulty": 60.572786294554405
},

Example
Request data:
{
 "id": "1",
 "method": "SerpstatDomainProcedure.getAdKeywords",
 "params": {
   "domain": "nike.com",
   "se": "g_us",
   "sort": {"cost": "desc"},
   "url": "https://www.nike.com/nike-by-you",
   "keywords": ["nike", "id"],
   "minusKeywords": ["nikeid "],
   "filters": { "queries_from":"100", "queries_to": "3000"},
   "page": "1",
   "size": "20"
 }
}

Response data:
{
    "id": "1",
    "result": {
        "data": [
            {
                "keyword": "customize id nike",
                "keyword_length": 3,
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "url": "https://www.nike.com/nike-by-you",
                "title": "Custom Nike Shoes - Nike By You Shoe Customizer",
                "text": "Pick From Your Favorite Nike Styles & Color Them To Reflect Your Unique Personality.",
                "position": 1,
                "type": "1",
                "cost": 2.54,
                "concurrency": 59,
                "found_results": 24800000,
                "region_queries_count": 320,
                "region_queries_count_wide": 0,
                "types": [
                    "ads_top",
                    "also_asks"
                ],
                "geo_names": [],
                "difficulty": 60.572786294554405
            },
            {
                "keyword": "nike customized id",
                "keyword_length": 3,
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "url": "https://www.nike.com/nike-by-you",
                "title": "Nike By You - Nike By You Shoe Customizer",
                "text": "Pick From Your Favorite Nike Styles & Color Them To Reflect Your Unique Personality. Performance, Fit & Style Your Way. Custom Shoes for Men, Women, Boys & Girls. Free Shipping For Members.",
                "position": 1,
                "type": "1",
                "cost": 1.8799999999999999,
                "concurrency": 45,
                "found_results": 34900000,
                "region_queries_count": 320,
                "region_queries_count_wide": 0,
                "types": [
                    "ads_top",
                    "also_asks"
                ],
                "geo_names": [],
                "difficulty": 69.231493915430917
            }
        ],
        "summary_info": {
            "page": 1,
            "total": 10,
            "left_lines": 999267
        }
    }
}

Share this article with your friends

Are you sure?

Introducing Serpstat

Find out about the main features of the service in a convenient way for you!

Please send a request, and our specialist will offer you education options: a personal demonstration, a trial period, or materials for self-study and increasing expertise — everything for a comfortable start to work with Serpstat.

Name

Email

Phone

We are glad of your comment
I agree to Serpstat`s Privacy Policy.

Thank you, we have saved your new mailing settings.

Open support chat