Advertising report with specified name of domain (ad_keywords)

The ad_keywords 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

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)

Response parameters
Parameter	Description
result	Contains the answer
total	Number of paid keywords of the domain
hits	Contains the answer
keyword	Keyword which domain's ad is displayed in SERP
keyword_length	Number of words divided by space in a keyword
domain	Domain
subdomain	Subdomain of the domain
url	Ad URL
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	Keyword competition in PPC (0-100%)
found_results	The number of results found for the keyword
region_queries_count	Search volume in selected search engine database
region_queries_count_last	Search volume (last month)
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 credits are exceeded (number of simultaneous requests or account credits)
left_lines	API credits remaining

Part of the API response for which you spend 1 credit:

 {
    "keyword": "nike koshes",
    "keyword_length": 2,
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "url": "https://www.nike.com/gb/w/sale-3yaep",
    "title": "Nike.com Official Clearance - Stock Up On Clearance Shoes",
    "text": "Nike Clearance Gear Gives You A Chance To Add Top-Flight Products To Your Collection. Find The Items That Match Your Style And Complete Your Look. Shop Clearance Now. Medical Workers Save 10% Shop With Nike Experts. Free Shipping for Members.",
    "position": 1,
    "type": "1",
    "cost": 0.29999999999999999,
    "concurrency": 100,
    "found_results": 64,
    "region_queries_count": 1000000,
    "region_queries_count_last": 10,
    "types": [
        "ads_top"
    ],
    "geo_names": [],
    "difficulty": null,
    "_id": "4754893372_1"
},

Example

Request data:

api.serpstat.com/v3/ad_keywords?query=nike.com&token=XXX&se=g_us

Response data:

{
    "result": {
        "total": 1537,
        "hits": [
            {
                "keyword": "nike koshes",
                "keyword_length": 2,
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "url": "https://www.nike.com/gb/w/sale-3yaep",
                "title": "Nike.com Official Clearance - Stock Up On Clearance Shoes",
                "text": "Nike Clearance Gear Gives You A Chance To Add Top-Flight Products To Your Collection. Find The Items That Match Your Style And Complete Your Look. Shop Clearance Now. Medical Workers Save 10% Shop With Nike Experts. Free Shipping for Members.",
                "position": 1,
                "type": "1",
                "cost": 0.29999999999999999,
                "concurrency": 100,
                "found_results": 64,
                "region_queries_count": 1000000,
                "region_queries_count_last": 10,
                "types": [
                    "ads_top"
                ],
                "geo_names": [],
                "difficulty": null,
                "_id": "4754893372_1"
            },
            {
                "keyword": "nicke air force",
                "keyword_length": 3,
                "domain": "nike.com",
                "subdomain": "www.nike.com",
                "url": "https://www.nike.com/w",
                "title": "Nike Air Force 1 - Nike Official Site",
                "text": "An Iconic Shoe Designed To Keep You Comfortable On & Off The Court. Shop The Official Nike Store For The Latest Nike Shoes, Apparel & Gear. Air Cushioning. Free Shipping for Members. Leather Upper. Models: Low, High, Sage, Jester, Shadow, Gore-Tex, Retro, Utility.",
                "position": 1,
                "type": "1",
                "cost": 0.39000000000000001,
                "concurrency": 100,
                "found_results": 78,
                "region_queries_count": 823000,
                "region_queries_count_last": 823000,
                "types": [
                    "ads_top",
                    "shopping_top",
                    "also_asks"
                ],
                "geo_names": [],
                "difficulty": null,
                "modified_date": "2021-04-22",
                "_id": "693985318_1"
            }
        ]
    },
    "status_msg": "OK",
    "status_code": 200,
    "left_lines": 998017
}