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

PPC Keyword Competitors List V4 (SerpstatKeywordProcedure.getAdsCompetitors)

SerpstatKeywordProcedure.getAdsCompetitors — this method performs competitors' search for the given keyword.

Request parameters
Parameter Description Type Optional Default value Value Options
query Keyword by which competitors will be searched string no iphone xs
se Search engine ID string no g_us
page Page number in response int yes 1 5
pageSize Number of results per page in response int yes 100 50-1000

Sort direction:

desc — descending;

asc  ascending


json object yes {"common": "desc"}

Response parameters
Parameter Description
domain Competitor's domain
ads Number of ads for a domain
all Number of keywords for a domain in PPC
common Common keywords in PPC
summary_info Summary data block
page Current page
left_lines Number of remaining API lines

The number of credits spent corresponds to the number of results obtained. This is part of the API response for which 1 credit is charged:

"domain": "",
"ads": 3785,
"all": 9272,
"common": 231

Example PHP Python
Request data:

    "id": 1,
    "method": "SerpstatKeywordProcedure.getAdsCompetitors",
    "params": {
        "query": "iphone xs",
        "se": "g_us",
        "page": 1,
        "pageSize": 100,
        "sort": {
            "common": "desc"

Response data:
    "id": "1",
    "result": {
        "data": [
                "domain": "",
                "ads": 3785,
                "all": 9272,
                "common": 231
        "summary_info": {
            "page": 1,
            "left_lines": 999529

Share this article with your friends

Sign In Free Sign Up

You’ve reached your query limit.

Or email
Forgot password?
Or email
Back To Login

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

Are you sure?


To complete your registration you need to enter your phone number


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.




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.

View Editing


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