API Reference

ChatGPT Ads / API Reference

openai_ads_get_ad

OpenAI Ads tool — manages ads shown inside ChatGPT via the OpenAI Ads API. Retrieve a single ad by ID, including creative and review_status. GET /ads/{id}.

This is a read-only tool: it retrieves ad 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:

Get ad in my ChatGPT Ads account for [ad id].

It takes 1 required and 0 optional parameters.

Parameters

ParameterTypeRequiredDescription
ad_idstringYesAd Id

Related ChatGPT Ads tools

Before you can call it

This tool needs a connected ChatGPT Ads account. The ChatGPT Ads connect guide covers how to authorize it and what it unlocks, and the quickstart gets a client talking to the server in about five minutes.

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.