list_change_events
List change events picked up by Adlyse’s ad sync for an account. Use these to correlate metric shifts with what changed on the platform — they pair naturally with get_impact_analysis and the decision log.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
ad_account_id | string | yes | Ad account id | |
since | string? | no | null | ISO-8601 datetime — only events at or after |
change_type | string? | no | null | keyword, budget, creative, bid_strategy, targeting, status, or other |
limit | integer | no | 50 | Max events to return; clamped to 500 |
offset | integer | no | 0 | Pagination offset |
Returns#
json
{
"events": [
{
"title": "Budget increased",
"date": "2026-04-20T09:15:00Z",
"change_type": "budget",
"source": "snapshot_diff",
"description": "Daily budget raised from $100 to $125",
"changed_by": "jane@acme.com",
"platform": "meta_ads",
"campaign_id": "c1",
"ad_group_id": null
}
],
"total": 34,
"offset": 0,
"limit": 50,
"has_more": false,
"source": "adlyse.ads_change_events@v1"
}| Field | Description |
|---|---|
events[].source | api (from the platform’s change history) or snapshot_diff (detected by Adlyse) |
events[].changed_by | Populated when the platform exposes the user; blank for snapshot-diff events |
Events are returned newest-first by date.
Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |
not_found | Ad account doesn’t belong to your org |
validation_error | Malformed since |
Change-type values#
| Value | Covers |
|---|---|
keyword | Keyword add / remove / match-type change (Google) |
budget | Daily / lifetime budget edits |
creative | Ad / creative swap, image or video replace |
bid_strategy | Bidding strategy switch (target_cpa, target_roas, manual_cpc, etc.) |
targeting | Audience / location / demographic edits (Meta: ad-set targeting) |
status | Pause / resume / remove |
other | Anything not matching above |
Example#
Request:
json
{
"ad_account_id": "ad_acct_abc",
"change_type": "budget",
"since": "2026-04-15T00:00:00Z"
}Response: as shown above.
See also#
get_impact_analysis— correlates events with metric shifts