API Reference

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

ParameterTypeRequiredDescription
ad_group_idstringNoAd Group Id
limitintegerNoLimit
afterstringNoAfter
orderstringNoOrder

Related ChatGPT Ads tools

Start using MCP Ads