List Ads
Lists the ads for an account, with stats over the requested window.
Authorizations
An account API key, account scoped JWT, app API key, or user OAuth token.
Headers
Pins the request to a dated API version. When omitted, the request uses the original (2025-01-01) request/response shapes, so existing unversioned callers are never broken. Generated SDKs always send the latest version they were built against. An unrecognized value is rejected with a 400. The schemas documented here always describe the latest version.
"2026-06-20"
Query Parameters
The account the ads belong to. Defaults to the account-scoped key's own account.
Only return ads in this ad campaign.
Only return ads in this ad group.
Only return ads with this status.
active, paused, in_review, rejected Filter ads by a title or ID substring.
The field to sort by. Defaults to created_at.
created_at, updated_at The sort direction. Defaults to desc.
asc, desc Only return ads created before this timestamp.
Only return ads created after this timestamp.
Start of the stats window. Defaults to all-time.
End of the stats window. Defaults to now.
The number of ads to return.
x <= 100Cursor to fetch the page after (from page_info.end_cursor).
The number of ads to return from the end of the range.
x <= 100Cursor to fetch the page before (from page_info.start_cursor).

