Retrieve an Ad
Retrieves a single ad 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"
Path Parameters
The ad ID.
Query Parameters
Start of the stats window.
End of the stats window.
IANA timezone the stats window is interpreted in. Defaults to UTC.
Response
ad retrieved
The ad campaign this ad belongs to, an object with an id.
The ad group this ad belongs to, an object with an id.
Whop pixel-attributed add-to-cart events, last-click.
The call-to-action button shown on the ad.
learn_more, shop_now, sign_up, subscribe, get_started, book_now, apply_now, contact_us, download, order_now, buy_now, get_quote, message_page, whatsapp_message, instagram_message, call_now, get_directions, send_updates, get_offer, watch_more, listen_now, play_game, open_link, no_button, get_offer_view, get_event_tickets, see_menu, request_time, event_rsvp, see_details, view_instagram_profile, null "learn_more"
Clicks divided by impressions, between 0 and 1.
The number of clicks.
Whop pixel-attributed complete-registration events, last-click.
Whop pixel-attributed contact events, last-click.
Spend divided by attributed add-to-cart events; null when they are not the goal and none are attributed.
Spend divided by clicks; 0 when there are no clicks.
Spend divided by attributed complete-registration events; null when they are not the goal and none are attributed.
Spend divided by attributed contact events; null when contacts are not the goal and none are attributed.
Spend divided by attributed leads; null when leads are not a goal and none are attributed.
Spend per 1,000 impressions; 0 when there are no impressions.
Spend divided by attributed purchases; null when purchases are not a goal and none are attributed.
Spend divided by Whop pixel-attributed results; null when nothing Whop-attributable is being optimized for.
Spend divided by attributed schedule events; null when schedules are not the goal and none are attributed.
Spend divided by attributed submit-application events; null when they are not the goal and none are attributed.
Spend divided by attributed view-content events; null when they are not the goal and none are attributed.
When the ad was created, as an ISO 8601 timestamp.
Whop pixel-attributed custom (merchant-defined) conversion events, last-click, across all custom event names.
The current delivery state, mirroring the Delivery column in the ads dashboard. When several states apply at once, the highest-precedence one is returned.
rejected, in_review, draft, campaign_paused, ad_group_paused, paused, processing, issues, learning_limited, learning, active "rejected"
The description variants shown on the ad.
Platform-reported impressions divided by reach.
The headline variants shown on the ad.
Unique identifier for the ad.
The number of impressions.
The instant lead form on the ad (Meta lead ads), or null when the ad group's conversion_location is not an instant-form destination. An object with name, form_type (more_volume or higher_intent), an optional intro, questions, a privacy_policy, an optional completion screen, and phone_verification.
The Meta lead form the ad uses. Set when the ad references an existing form via lead_form_id, or once a form built from lead_form has been created on Meta at launch.
Whop pixel-attributed leads, last-click.
The click-to-message welcome copy, an object with message and keyword, or null when the ad has none.
Whether the ad can appear alongside other advertisers' ads in the same unit. Defaults to true.
The existing post this ad promotes (a Facebook post or Instagram media), or null when it uses uploaded creatives.
Which network post_id refers to — facebook (a page post) or instagram (a media id) — or null when the ad uses uploaded creatives.
facebook, instagram, null "facebook"
Preview image of the existing post this ad promotes. Null for ads that use uploaded creatives, or until the post's media has been fetched from the network.
The primary text variants shown in the ad body.
USD value of pixel-attributed purchases.
Whop pixel-attributed purchases, last-click.
The number of unique people who saw this.
The Whop pixel conversion event whose attributed count represents results — the optimization goal, or the highest-volume attributed event for campaigns that budget per ad group. Null when the goal isn't a Whop-attributed event.
purchase, lead, schedule, submit_application, contact, complete_registration, view_content, add_to_cart, custom, null "purchase"
The merchant-defined event name when result_event is custom; null for the standard events.
Purchase value divided by spend, both in USD (a currency-neutral ratio); 0 when there is no spend.
Whop pixel-attributed schedule events, last-click.
The amount charged, in spend_currency.
The ISO 4217 currency code of all monetary metrics.
The delivery status of the ad.
active, paused, in_review, rejected "active"
Whop pixel-attributed submit-application events, last-click.
The display title of the ad. Falls back to the creative set caption when unset.
Unique clicks divided by impressions, between 0 and 1.
The number of unique clicks.
When the ad was last updated, as an ISO 8601 timestamp.
The URL the ad links to.
Query parameters appended to the URL, as a string-to-string map.
Whop pixel-attributed view-content events, last-click.

