ChatGPT Ads / API Reference
openai_ads_list_ads
OpenAI Ads tool — manages ads shown inside ChatGPT via the OpenAI Ads API. List ads, optionally filtered to an ad group. GET /ads.
This is a read-only tool: it lists ads from 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:
List ads in my ChatGPT Ads account.
It takes 0 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
ad_group_id | string | No | Ad Group Id |
limit | integer | No | Limit |
after | string | No | After |
order | string | No | Order |
Related ChatGPT Ads tools
openai_ads_list_ad_groupsopenai_ads_list_campaignsopenai_ads_ad_insightsopenai_ads_create_ad_groupopenai_ads_create_campaignopenai_ads_create_chat_card_ad
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.