Get Account Insights
Get ad account insights for the organization’s OpenAI Ads partner brand.
aggregation_level=campaign returns one row per campaign (with campaign_id
/ campaign_name and all metrics), so every campaign’s insights come back in
a single call; time_granularity=daily gives per-day rows (e.g. daily spend).
Authorizations
Query Parameters
Organization scope for API keys that can access multiple organizations.
Row entity for the insights breakdown. campaign returns one row per campaign.
ad_account, campaign, ad_group, ad Time bucket for the rows; none or omitted returns totals over the whole range.
hourly, daily, monthly, none Time ranges as JSON objects, e.g. {"type": "date_range", "since": "2026-07-01", "until": "2026-07-18"}.
Maximum rows to return.
1 <= x <= 2000Return items after this ID (forward pagination).
Return items before this ID (backward pagination).
Response
Successful Response
Cursor-paginated insights, mirroring the OpenAI Ads insights envelope.
Insight rows.
Total row count, when reported upstream.
ID of the first item; pass as before to page back.
ID of the last item; pass as after to page forward.
Whether more items are available.