Get Ads for Domain

get

https://api.spyfu.com/apis/serp_api/v2/ppc/getPaidSerps

Returns paid search results (ads) that a domain appears in across Google search. This endpoint reveals the competitive paid landscape to identify advertising opportunities and understand competitor PPC strategies.

Visualize this API live on SpyFu

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

query

string

required

Domain to analyze for paid search presence.

includeTerms

string

Comma-separated list of terms that must be present in the keyword.

includeAnyTerm

boolean

Defaults to false

Used with includeTerms. If true: match any term (OR). If false: require all terms (AND).

excludeTerms

string

Comma-separated list of terms to exclude from results (e.g., branded or irrelevant terms).

searchVolume.min

float

Filter to keywords where monthly search volume (Google) is ≥ this value.

searchVolume.max

float

Filter to keywords where monthly search volume (Google) is ≤ this value.

adCount.min

float

Filter to keywords where the number of distinct advertisers observed over the last 14 months is ≥ this value.

adCount.max

float

Filter to keywords where the number of distinct advertisers observed over the last 14 months is ≤ this value.

keywordDifficulty.min

float

Filter to keywords where the keyword difficulty score is ≥ this value (0-100; higher = harder to rank).

keywordDifficulty.max

float

Filter to keywords where the keyword difficulty score is ≤ this value (0-100; higher = harder to rank).

pageSize

int32

1 to 10000

Defaults to 5

The maximum number of rows returned.

excludeHomepageKeywords

boolean

Defaults to false

If true, exclude keywords where the domain/URL's homepage (root domain, e.g., example.com) ranks; if false, include all.

countryCode

string

enum

Defaults to US

Country market to search. Specifically, this maps to the Google domain version to query against (e.g., google.com for US, google.de for Germany, etc.). All Countries

sortBy

string

enum

Defaults to SearchVolume

Column to sort results by.

Show Details

SearchVolume	Number of searches done this past month on Google (or within selected country). Blended from multiple sources for better snapshot of search activity
KeywordDifficulty	PPC ranking difficulty score (0-100 scale, higher = more difficult to rank). Based on advertiser competition, cost-per-click, and bid density for paid search results
AdPosition	Average position where the domain's ads appear in paid search results (1 = top ad position)
AdCount	Total number of advertisers seen over the last 6 months for this keyword
DateSearched	Most recent date this keyword data was updated in SpyFu's database

Allowed:

sortOrder

string

enum

Defaults to Descending

Order to sort the results.

Allowed:

startingRow

int32

1 to 10000

Defaults to 1

Row number to start the results with.

adultFilter

boolean

Defaults to true

Exclude adult keywords considered unsafe for work.

onlyAdultKeywords

boolean

Defaults to false

Only include adult keywords considered unsafe for work.

Responses

400

Bad Request - Invalid parameters provided (e.g., invalid domain format, pageSize exceeds maximum, or invalid country code)

401

Unauthorized - Invalid API credentials or insufficient permissions to access PPC keyword data

500

Internal Server Error - A server-side error occurred while processing the request

200Successfully retrieved paid search results for the domain. Returns a paginated list of keywords where the domain appears in paid ads with position and competition data.