---
title: "Get Domain Ad History"
method: GET
path: "/v2/domain/getDomainAdHistory"
tags: ["Ad History Research API"]
---

# Get Domain Ad History

`GET /v2/domain/getDomainAdHistory`

Returns historical ad variations and copy for a specific domain. This endpoint focuses on ads from a particular advertiser across all their keywords and campaigns, unlike term-based endpoints that focus on specific keywords.

[Visualize this API live on SpyFu](https://www.spyfu.com/ppc/ad-history/domain?query=example.com)

## Query parameters

- `domain` string, required
- `keywordFilter` string
- `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` 'Best' | 'Worst' | 'KeywordAsc' | 'KeywordDesc' | 'SearchDateId'
- `pageSize` integer
- `startingRow` integer

## Response `200`

Successfully retrieved ad history data for the specified domain. Returns a paginated list of historical ad variations with copy, keywords, and campaign information.

- object — Response wrapper containing domain ad history results with pagination metadata.
  - `resultCount` integer — Number of results returned
  - `results` object[], nullable — Array of ads with their associated keywords found for the specified domain.
    - `keywords` string[], nullable — List of keywords that triggered this ad to appear in search results.
    - `position` integer — The ad's position on the search results page when it was captured (1 = top position).
    - `searchDateId` integer — Date when this ad was captured by SpyFu's crawling system, formatted as YYYYMMDD (e.g., 20231215 = December 15, 2023).
    - `title` string, nullable — The headline text of the ad as it appeared in search results.
    - `body` string, nullable — The description text of the ad providing additional details about the offer.
    - `url` string, nullable — The landing page URL that the ad directed users to when clicked.
    - `adId` integer — Unique identifier for this specific ad in SpyFu's database.

## 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 ad history 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)