API Reference

Get Keyword Ad History

get
https://api.spyfu.com/apis/cloud_ad_history_api/v2/term/getTermAdHistory

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

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

Keyword to retrieve advertising history for.

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

int32
1 to 10000
Defaults to 5

Number of ad history records to return per page.

int32
1 to 2147483647
Defaults to 1

Starting row number for pagination.

Responses

400

Bad Request - Invalid parameters provided (e.g., empty term, 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 8 months ago

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

Updated 8 months ago