API Reference

Get Keyword Ad History With Stats

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

Returns historical ad variations and advertiser performance statistics for a specific keyword. This endpoint includes domain-level metrics alongside ad copy data, unlike the basic ad history endpoint that focuses purely on ad variations.

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 code to filter results by geographic market.

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 9 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 9 months ago