v1

latestOpenAPI 3.1.02026-07-24490622.0 KB

Ad History Research API

Get Keyword Ad History

Returns historical advertisers and ad variations for a specific keyword. This endpoint focuses on ads that have appeared for a particular keyword, unlike domain-based endpoints that focus on ads from specific advertisers.

Visualize this API live on SpyFu

get/v2/term/getTermAdHistory

Query parameters

termstring required

Example:running shoes

Keyword to retrieve advertising history for.

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>

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 keyword. Returns a paginated list of ads that have appeared for this keyword across different advertisers.

resultCountinteger

Number of results returned

Example response

{
  "resultCount": 100,
  "results": [
    {
      "domainName": "example.com",
      "urls": [
        "https://example.com/running-shoes",
        "https://example.com/athletic-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.",
      "adId": 12345678
    }
  ]
}