v1

latestOpenAPI 3.1.02026-07-24490622.0 KB

PPC Research API

Get Ads for Domain

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

get/v2/ppc/getPaidSerps

Query parameters

querystring required

Example:example.com

Domain to analyze for paid search presence.

includeTermsstring

Example:hosting,domain,website

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

includeAnyTermboolean

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

excludeTermsstring

Example:free,cheap,discount

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

searchVolume.minnumber float

Example:1000

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

searchVolume.maxnumber float

Example:50000

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

adCount.minnumber float

Example:3

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

adCount.maxnumber float

Example:25

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

keywordDifficulty.minnumber float

Example:30

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

keywordDifficulty.maxnumber float

Example:70

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

pageSizeinteger

Example:5

The maximum number of rows returned.

excludeHomepageKeywordsboolean

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

countryCode'AR' | 'AT' | 'AU' | 'BE' | 'BR' | 'CA' | 'CH' | 'DE' | 'DK' | 'ES' | 'FR' | 'IE' | 'IN' | 'IT' | 'JP' | 'MX' | 'NL' | 'NO' | 'NZ' | 'PL' | 'PT' | 'SE' | 'SG' | 'TR' | 'UA' | 'UK' | 'US' | 'ZA'

Example: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.). <a href='https://developer.spyfu.com/reference/adhistoryapi_getdomainadhistory_get#/'>All Countries</a>

sortBy'SearchVolume' | 'KeywordDifficulty' | 'AdPosition' | 'AdCount' | 'DateSearched'

Example:SearchVolume

Column to sort results by.

sortOrder'Ascending' | 'Descending'

Example:Descending

Order to sort the results.

startingRowinteger

Example:1

Row number to start the results with.

adultFilterboolean

Example:true

Exclude adult keywords considered unsafe for work.

onlyAdultKeywordsboolean

Only include adult keywords considered unsafe for work.

Response

Successfully 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.

resultCountinteger

Number of results returned

totalMatchingResultsinteger

Total number of paid keywords available that match the query criteria, including results not included in the current page.

Example response

{
  "resultCount": 100,
  "results": [
    {
      "keyword": "running shoes",
      "termId": "39100280",
      "adPosition": 1,
      "adCount": 1,
      "dateSearched": "2023-12-15T10:30:00Z",
      "title": "Best Running Shoes 2024 - Free Shipping",
      "domain": "example.com",
      "searchVolume": 700000,
      "keywordDifficulty": 69
    }
  ],
  "totalMatchingResults": 50000
}