Domain's ads 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

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 (there are both Google and Yandex databases available, for example: g_us or y_157).	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
        }
    }
}