c363cb2feb95
List Ad Campaigns
Lists the ad campaigns for an account, with stats over the requested window.
Query parameters
The account the campaigns belong to. Defaults to the account-scoped key's own account.
Only return campaigns with this status.
Filter campaigns 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.
The sort direction. Defaults to desc.
Only return campaigns created before this timestamp.
Only return campaigns 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.
Attribution model the conversion stats count under (defaults to last_touch). Under both models a journey with any whop ad touch attributes to whop; the model picks which whop touch credits the entity and which non-whop source wins otherwise.
The number of campaigns to return.
Cursor to fetch the page after (from page_info.end_cursor).
The number of campaigns to return from the end of the range.
Cursor to fetch the page before (from page_info.start_cursor).
Response
ad campaigns listed
Example response
{
"data": [
{
"added_to_cart_value": 12650,
"added_to_carts": 165,
"bid_type": "average_target",
"budget_amount": 50,
"budget_optimization": "ad_group",
"budget_type": "daily",
"click_through_rate": 0.025,
"clicks": 5500,
"completed_registration_value": 1650,
"completed_registrations": 55,
"contact_value": 2640,
"contacts": 88,
"cost_per_added_to_cart": 8,
"cost_per_click": 0.24,
"cost_per_completed_registration": 24,
"cost_per_contact": 15,
"cost_per_lead": 10,
"cost_per_mille": 6,
"cost_per_purchase": 30,
"cost_per_result": 40,
"cost_per_schedule": 22,
"cost_per_submitted_application": 120,
"cost_per_unique_click": 0.4,
"cost_per_viewed_content": 1.1,
"created_at": "2026-01-01T12:00:00.000Z",
"custom_conversions": 41,
"custom_event_counts": {
"gift_card_purchased": 5,
"quote_requested": 33
},
"custom_event_values": {
"gift_card_purchased": 750,
"quote_requested": 0
},
"delivery_status": "issues",
"id": "adcamp_xxxxxxxxxxxxxx",
"impressions": 220000,
"issues": [
{
"id": "adiss_xxxxxxxxxxxxxx",
"message": "Your ad was rejected for unacceptable business practices. Edit the ad's content and resubmit.",
"resource_id": "ad_xxxxxxxxxxxxxx",
"resource_type": "ad"
}
],
"lead_value": 3960,
"leads": 132,
"objective": "leads",
"platform": "meta",
"purchase_value": 7920,
"purchases": 44,
"result_event": "custom",
"result_event_name": "quote_requested",
"results": 33,
"return_on_ad_spend": 6,
"schedule_value": 5400,
"schedules": 60,
"special_ad_categories": [
"employment"
],
"spend": 1320,
"spend_currency": "usd",
"status": "active",
"submitted_application_value": 1320,
"submitted_applications": 11,
"title": "Ceramic coating — Austin leads",
"unique_clicks": 3300,
"updated_at": "2026-01-01T12:00:00.000Z",
"viewed_content_value": 8400,
"viewed_contents": 1200
}
],
"page_info": {
"end_cursor": "WyJjdXJzb3IiLDFd",
"start_cursor": "WyJjdXJzb3IiLDFd"
}
}