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

Share this article with your friends

Sign In Free Sign Up

You’ve reached your query limit.

Or email
Forgot password?
Or email
Optional
Back To Login

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

Are you sure?

Awesome!

To complete your registration you need to enter your phone number

Back

We sent confirmation code to your phone number

Your phone Resend code Queries left

Something went wrong.

Contact our support team
Or confirm the registration using the Telegram bot Follow this link
Please pick the project to work on

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
Upgrade your plan

Upgrade your plan

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

Sign Up Free

Thank you, we have saved your new mailing settings.

Invite
View Editing

E-mail
Message
Optional
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
Open support chat