Get access to 30+ marketing and SEO tools. analyze competitors, keywords, and backlinks for free..
Sign in Sign Up

We use cookies to make Serpstat better. By clicking "Accept cookies", you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. Learn more

Advertising report with specified name of domain V4 (SerpstatDomainProcedure.getAdKeywords)

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

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 key phrases 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

To filter the results, use the following parameters:

Parameter Description Possible values
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-100000000
queries_to max number of monthly searches  0-100000000
cost_from min CPC  0-200
cost_to max CPC  0-200
concurrency_from min level of competition  0-100
concurrency_to max level of competition  0-100

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
        }
    }
}