Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
ChatGPT Ads Insights
ChatGPT Ads delivery report with every option OpenAI offers: hourly/daily/monthly buckets, platform/country/device breakdowns, zero-impression rows and conversion metrics.
- Type
- Reads only
- Credits
- 1
- Platform
- ChatGPT Ads
- Approval
- Not needed, nothing changes
What it does
ChatGPT Ads delivery report with every option OpenAI offers: hourly/daily/monthly buckets, platform/country/device breakdowns, zero-impression rows and conversion metrics.
`scope_id` narrows to one campaign/ad group/ad (cmpn_/adgrp_/ad_); empty = whole account. `level`: account | campaign | ad_group | ad — one row per entity at that level. `granularity`: none (period total) | hourly (about 30 days of history) | daily | monthly; times are in the account time zone. `segment`: platform (android_app, android_web, desktop_web, ios_app, ios_web, web) | country | device | product — one at a time, not with hourly, not with conversions. `include_zero=true` adds campaigns/groups/ads that got no impressions (unsegmented only), which is how you see what is NOT delivering. `conversions=true` (granularity none or daily only) adds conversions, cpa, post_click_cvr, attributed sales and ROAS (null means not computable, not zero; conversions settle over about a day). Spend, CPC and CPM are in the account currency. Dates are YYYY-MM-DD (end inclusive); without dates the last `days` days. Every matching row is retained: `limit` controls only this response, and `page_token=next_page_token` reads the cached continuation without another API call or credit. `offset` remains supported for compatibility. Read-only.
MCP: chatgpt_ads_insights
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| account | string | Optional | · | Connected account selector for this operation. Use the exact account ID or account value accepted by this tool; when in doubt, obtain it from the relevant account-listing tool. |
| scope_id | string | Optional | · | Exact scope identifier to target. Use the ID returned by an Opus Growth list or create operation, not a display name. |
| level | string | Optional | campaign | account · campaign · ad_group · ad · adgroup · ad_set · ad_groups · campaigns · ads · ad_account · Entity or reporting aggregation level to use, such as campaign, ad group, ad, or keyword when supported. |
| days | integer | Optional | 7 | Number of calendar days to look back from now for this analysis or report. |
| start_date | string | Optional | · | Inclusive start date for the requested period, in the format required by this tool. |
| end_date | string | Optional | · | Inclusive end date for the requested period, in the format required by this tool. |
| granularity | string | Optional | none | Exact granularity value for chatgpt ads insights. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| segment | string | Optional | · | Exact segment value for chatgpt ads insights. Supply text in the provider's required format; when it selects an existing resource, use the exact identifier returned by the relevant list or search operation. |
| include_zero | boolean | Optional | false | Whether to include zero in this operation's result or change. |
| conversions | boolean | Optional | false | Whether to enable conversions for this operation. |
| limit | integer | Optional | 0 | Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete. |
| offset | integer | Optional | 0 | Zero-based position at which to start reading results. Use the next_offset returned by the previous response when present. |
| page_token | string | Optional | · | Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page. |
Related tools
chatgpt_ads_ad_previewChatGPT Ads Conversion Setupchatgpt_ads_conversion_setupChatGPT Ads Object Detailschatgpt_ads_detailsChatGPT Ads Location Lookupchatgpt_ads_geo_lookupChatGPT Ads Spend Limitschatgpt_ads_spend_limitsChatGPT Ads Statuschatgpt_ads_statusConnect ChatGPT Adsconnect_chatgpt_adsCreate ChatGPT Ads Adcreate_chatgpt_ads_adCreate ChatGPT Ads Ad Groupcreate_chatgpt_ads_ad_group