API Reference

Get Domain Ad History by Date

get
https://api.spyfu.com/apis/cloud_ad_history_api/v2/domain/getDomainAdHistoryByDate

Returns one row per keyword, search date, and ad variation for a domain. Use the date bounds and paging fields to pull a controlled slice while still seeing the total matching result size.

Visualize this API live on SpyFu

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Advertiser's root domain.

string

Only include keywords containing this text.

int32
19000101 to 29991231

Earliest ad capture date to include, formatted as YYYYMMDD.

int32
19000101 to 29991231

Latest ad capture date to include, formatted as YYYYMMDD.

int32
1 to 2147483647
Defaults to 1

Starting row number for pagination.

int32
1 to 10000
Defaults to 100

Number of flattened ad history rows to return per page.

int32
1 to 2147483647
Defaults to 1

Keyword/domain document row number to start the backing query with before flattening date rows. KeywordStartingRow plus KeywordPageSize must fit within the first 10,000 keyword/domain documents.

int32
1 to 10000
Defaults to 10000

Number of keyword/domain documents to fetch before flattening date rows. KeywordStartingRow plus KeywordPageSize must fit within the first 10,000 keyword/domain documents.

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

Responses

400

Bad Request - Invalid parameters provided (e.g., invalid date bounds, 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

Updated 4 days ago

Language
Credentials
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 days ago