v1

latestOpenAPI 3.1.02026-07-24490622.0 KB

Ad History Research API

Get Domain Ad History

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

get/v2/domain/getDomainAdHistory

Query parameters

domainstring required

Example:example.com

Advertiser's root domain

keywordFilterstring

Filter down to keywords containing this value

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'Best' | 'Worst' | 'KeywordAsc' | 'KeywordDesc' | 'SearchDateId'

Example:Best

Sort order for grouped domain ad history results.

pageSizeinteger

Example:5

Number of ad history records to return per page.

startingRowinteger

Example:1

Starting row number for pagination.

Response

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

resultCountinteger

Number of results returned

Example response

{
  "resultCount": 100,
  "results": [
    {
      "keywords": [
        "running shoes",
        "athletic shoes",
        "sports footwear"
      ],
      "position": 1,
      "searchDateId": 20231215,
      "title": "Best Running Shoes 2024 - Free Shipping",
      "body": "Discover premium running shoes with advanced cushioning technology. Shop now and save 20% on your first order.",
      "url": "https://example.com/running-shoes",
      "adId": 12345678
    }
  ]
}