ChatGPT Ads / API Reference
openai_ads_ad_insights
OpenAI Ads tool — manages ads shown inside ChatGPT via the OpenAI Ads API. Get performance insights for an ad (impressions, clicks, spend over time). Args: ad_id: The ad to report on. time_granularity: 'daily' (default) or other granularity the API supports. limit: Number of time buckets to return (default 7).
This is a read-only tool: it returns ad insights for your ChatGPT Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Ad insights in my ChatGPT Ads account for [ad id].
It takes 1 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_id | string | Yes | Ad Id |
time_granularity | string | No | Time Granularity |
limit | integer | No | Limit |
Related ChatGPT Ads tools
openai_ads_create_ad_groupopenai_ads_create_campaignopenai_ads_create_chat_card_adopenai_ads_get_accountopenai_ads_get_adopenai_ads_get_ad_group
Start free — 30 tool calls a month
No card required. Connect Google Ads, Meta Ads, GA4 or Search Console and ask Claude for the outcome — it picks the tool.