Get Domain Ad History

get

https://api.spyfu.com/apis/cloud_ad_history_api/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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

domain

string

required

Advertiser's root domain

keywordFilter

string

Filter down to keywords containing this value

countryCode

string

enum

Defaults to 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.). All Countries

sortBy

string

enum

Sort order for ad history results.

Show Details

Best	Best performing keywords based on longevity, CPC, and testing frequency
Worst	Worst performing keywords that were tested and likely dropped
KeywordAsc	Keywords A-Z
KeywordDesc	Keywords Z-A

Allowed:

pageSize

int32

1 to 10000

Defaults to 5

Number of ad history records to return per page.

startingRow

int32

1 to 2147483647

Defaults to 1

Starting row number for pagination.

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

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

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