List Ads
Lists the ads for an account, with stats over the requested window.
Authorizations
A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************
Headers
Pins the request to a dated API version.
"2026-07-08-1"
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. Stat columns (spend, impressions, …) rank over the stats_from/stats_to window across the whole list, not just the current page. results, cost_per_result and return_on_ad_spend rank by the same Whop pixel-attributed values the response reports.
created_at, updated_at, spend, impressions, reach, clicks, unique_clicks, frequency, click_through_rate, results, cost_per_mille, cost_per_click, cost_per_result, return_on_ad_spend 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.
IANA timezone (e.g. America/New_York) the stats window is interpreted in. Bare stats_from/stats_to dates resolve to day boundaries on this clock. Defaults to UTC.
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).

