Reports

Recent ad copy changes across advertisers

Lists new ad copy versions first observed in the window for any advertiser on the project's monitored searches, newest first, each with the version it followed and a word-level diff. Use the changes to brief the SEM team on messaging and offers that appeared in monitored results. Observed creative changes do not show which version performed better; the tool measures what appeared in saved checks, not clicks or conversions. The same list as the Ad copy changes page. first_seen is when monitoring first observed the copy, not when the advertiser launched it. To tell a new version from an old one, up to 90 days before the window are also read. A copy change is not evidence of a policy issue.

get/projects/{project_id}/ad-copy-changes

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/ad-copy-changes
  • Auth: HTTP bearer

Path parameters

project_idstring required

The project: its id, its brand domain (for example nike.example) or its exact project or brand name. Unknown or ambiguous references return not_found; call list_projects then.

Query parameters

range'7d' | '14d' | '30d' | '12m' | 'custom'

Window ending today: 7d, 14d, 30d (default) or 12m. Use custom with from and to for fixed dates.

fromstring

First local day, YYYY-MM-DD (custom range).

tostring

Last local day, YYYY-MM-DD, included in full (custom range).

time_zonestring

IANA time zone for day boundaries, such as America/New_York. Defaults to the time zone of the person the credential acts for.

'google' | 'bing'
OR
string[]
'desktop' | 'mobile'
OR
string[]
'windows' | 'macos' | 'android' | 'ios' | 'unspecified'
OR
string[]
string
OR
string[]
string
OR
string[]
domainstring

Only advertiser domains containing this text.

limitinteger

Items per page, 1 to 200.

cursorstring

The next_cursor value from the previous page. Omit it for the first page.

Response

Recent ad copy changes across advertisers

totalinteger required
next_cursorstring nullable required

Pass as cursor to get the next page; null on the last page.

truncatedboolean required
request_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.