---
title: "Get Ads for Domain"
method: GET
path: "/v2/ppc/getPaidSerps"
tags: ["PPC Research API"]
---

# Get Ads for Domain

`GET /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](https://www.spyfu.com/ppc/keywords/domain?query=example.com)

## Query parameters

- `query` string, required
- `includeTerms` string
- `includeAnyTerm` boolean
- `excludeTerms` string
- `searchVolume.min` number, float
- `searchVolume.max` number, float
- `adCount.min` number, float
- `adCount.max` number, float
- `keywordDifficulty.min` number, float
- `keywordDifficulty.max` number, float
- `pageSize` integer
- `excludeHomepageKeywords` boolean
- `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'
- `sortBy` 'SearchVolume' | 'KeywordDifficulty' | 'AdPosition' | 'AdCount' | 'DateSearched'
- `sortOrder` 'Ascending' | 'Descending'
- `startingRow` integer
- `adultFilter` boolean
- `onlyAdultKeywords` boolean

## Response `200`

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.

- object — Response wrapper containing paid SERP keyword results with pagination metadata and total result counts.
  - `resultCount` integer — Number of results returned
  - `results` object[], nullable — Array of paid search keywords with comprehensive SERP data and performance metrics.
    - `keyword` string, nullable — The keyword that triggers this paid ad result.
    - `termId` string, nullable — Unique identifier for this keyword in SpyFu's database.
    - `adPosition` integer, nullable — Position where the ad appears on the search results page (1 = top position).
    - `adCount` integer, nullable — Total number of ads this domain has for this keyword.
    - `dateSearched` string, date-time — Date when this keyword was first discovered and added to SpyFu's database.
    - `title` string, nullable — Headline text of the paid search result as it appears in SERPs.
    - `bodyHtml` string, nullable — HTML content of the ad description and additional text displayed in the search result.
    - `domain` string, nullable — Domain name of the advertiser placing this paid search ad.
    - `searchVolume` integer, nullable — Monthly search volume for this keyword based on Google search data across the selected country/region.
    - `keywordDifficulty` integer — SEO difficulty score (1-100) indicating how challenging it would be to rank organically for this keyword, with 100 being most difficult.
    - `isNsfw` boolean, nullable — Indicates whether the search result contains content that may not be safe for work environments.
  - `totalMatchingResults` integer — Total number of paid keywords available that match the query criteria, including results not included in the current page.

## Other 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

---

[API](https://skmtc.net/spyfu/apis/domain-stats-api.md) · [All operations](https://skmtc.net/spyfu/apis/domain-stats-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spyfu/domain-stats-api/revisions/44f0aff08ed0/schema)