Read ChatGPT Ads
chatgpt_ads_readRead connected ChatGPT Ads data—campaigns, ad groups, ads, and performance insights—without changing or spending anything. Review ad status and pull spend, click, and impression metrics.
Instructions
Read-only ChatGPT Ads (OpenAI's ad platform) data of the ad account the user connected to Upload-Post in the dashboard; spending on it runs on the user's own OpenAI billing. Nothing here changes or spends anything. accounts (connected ad accounts, default first, with their linked profiles; never the key); account (live metadata of the chosen account); campaigns; campaign (campaign_id); ad_groups (campaign_id required); ad_group (ad_group_id); ads (ad_group_id required; each ad has review_status in_review|approved|rejected); ad (ad_id); lists take params limit (1-500, default 20), after (last_id of the previous page), before, order asc|desc. insights (whole account), campaign_insights (campaign_id), ad_group_insights (ad_group_id), ad_insights (ad_id): params since / until (YYYY-MM-DD, ad account timezone), time_granularity hourly|daily|monthly|none (default daily), aggregation_level ad_account|campaign|ad_group|ad, fields (list: impressions, clicks, spend, ctr, cpc, cpm and more), segments (list: product, country, device), filters / sort / time_ranges (lists of objects, passed to OpenAI), limit (1-2000), after, before. preview_ad (ad_id): a temporary preview link of the ad, valid 24 hours. 404 means no ChatGPT Ads account is connected, the profile has none linked, or the object does not exist; 401 can also mean OpenAI revoked the stored key and the account has to be reconnected in the dashboard.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "chatgpt_ads_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | No | The ad (ad, ad_insights, preview_ad, update/activate/pause/archive_ad). | |
| action | Yes | ||
| params | No | Other API fields for this action, with the REST API's own names (snake_case) and shapes. Paging and insights fields, as listed for each action. Leave out what you do not want to change. | |
| ad_group_id | No | The ad group (ad_group, ad_group_insights, update/activate/pause/archive_ad_group; ads lists the ads of this group; create_ad puts the ad in it). | |
| campaign_id | No | The campaign (campaign, campaign_insights, update/activate/pause/archive_campaign; ad_groups lists the groups of this campaign; create_ad_group puts the group in it). | |
| ad_account_id | No | Connected ad account to use (`adacct_...`, from chatgpt_ads_read accounts). Without it and without profile_username: the default account. | |
| profile_username | No | Use the ad account linked to this Upload-Post profile, and only that one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No |