Is there a ChatGPT Ads API?
Yes. OpenAI publishes a public Ads API at api.ads.openai.com for managing campaigns, ads, audiences, conversions and reports. Its documentation is at developers.openai.com/ads.
Developer guide
ChatGPT Ads API
OpenAI's Ads API is public. Advertisers can manage campaigns, ads, audiences, conversions and reports through api.ads.openai.com, and OpenAI documents it at developers.openai.com/ads.
Checked 29 Oct 2026 against official OpenAI Ads documentation.
The short answer
Yes, there is an official ChatGPT Ads API. Requests go to https://api.ads.openai.com/v1 with an Advertiser API key that you create in Ads Manager under Settings. Each key is scoped to one ad account.
How to get started with the ChatGPT Ads API
- 1Create or join an ad account in Ads Manager at ads.openai.com.
- 2Create an Advertiser API key in Ads Manager under Settings. Each key is scoped to one ad account.
- 3Send requests to https://api.ads.openai.com/v1, authenticated with that key.
- 4Follow OpenAI's API quickstart to create your first campaign, ad group and ad.
- 5Stay within the rate limits: 600 requests a minute per endpoint and 1,200 a minute overall.
Sources: OpenAI's Ads API documentation and API quickstart, checked 29 Oct 2026.
Open OpenAI's Ads API docsHow the ChatGPT Ads API is structured
An ad account contains campaigns, each campaign contains ad groups, and each ad group contains ads. OpenAI says to configure each setting at the level that owns it.
| Level | What you configure | Main endpoint |
|---|---|---|
| Ad account | Advertiser branding, currency, timezone, account access, spend limits | /v1/ad_account |
| Campaign | Objective, budget, schedule, geographic and platform targeting, audience inclusion and exclusion, conversion events | /v1/campaigns |
| Ad group | Bid strategy, context hints, audience bid multipliers, product set | /v1/ad_groups |
| Ad | Creative, image or product template, destination URL | /v1/ads |
OpenAI's first-campaign example creates the campaign, ad group and ad paused. Creating an ad submits its creative for review, and the ad, ad group and campaign are each activated with their own request.
Source: OpenAI's API overview, checked on 29 Oct 2026.
What you can do with the ChatGPT Ads API
| Area | What it covers |
|---|---|
| Campaigns, ad groups and ads | Create, list, update, activate, pause and archive them, and preview ads. |
| Images | Upload with POST /v1/upload: JPEG, PNG or WebP, at least 640 x 640 pixels. Accounts OpenAI has enabled can create ads with 4 to 6 square images. |
| Reporting | Insights for the ad account, campaigns, ad groups and ads, with country, device, platform and product breakdowns where enabled for the account. |
| Conversions | Pixels, Conversions API keys, event settings and conversion reporting. |
| Custom audiences | Create audiences, add or remove members, replace the full list, or merge 2 to 64 audiences into a new one. |
| Product feeds | Feeds, product sets and product-ad templates, with price, title and availability updates through delta feeds, where enabled for the account. |
| Locations | Look up country, region and market IDs with /v1/geo_lookup/search. |
| Audit logs | GET /v1/audit_logs lists recorded changes to resources in your ad account. |
| Bulk API | Up to 1,000 create or update operations per job. It is in limited preview and enabled per ad account. |
More: ChatGPT ads measurement for reporting, and ChatGPT shopping ads for product feeds.
What you can automate in Ads Manager without the API
Bulk upload in Ads Manager
Upload OpenAI's campaign schema to create campaigns, ad groups, context hints, creatives, bids, budgets, dates, and targeting at scale. Developers can also use OpenAI's separate Bulk API, which is in limited preview and enabled per ad account.
Bulk editing
Use Ads Manager bulk workflows to update larger sets of campaign objects.
Reporting export
Download daily or cumulative CSV reports for the selected date range.
Product feeds
Use OpenAI's documented product-feed workflow for eligible feed-based campaign creation.
Ads API versus the OpenAI model API
An API key created for the OpenAI model platform is not evidence of Ads API access. Ads Manager uses separate advertiser accounts, roles, campaign billing, and policy review. Never send an account key to an unofficial integration or infer endpoint paths from the model API.
Limits, retries and common errors
Rate limits
OpenAI enforces limits by both ad account and IP address: 600 requests a minute per endpoint and 1,200 a minute overall. Creating bulk jobs has a separate limit of 10 requests per 10 seconds for each ad account.
Safe retries
Supported create endpoints accept an Idempotency-Key. Reuse the same key and the same request when you retry the same creation, and use a new key for a new resource, so a network retry doesn't create a duplicate.
Common errors
| Problem | What to check |
|---|---|
| Authentication failure | The key type and the bearer header |
| Access denied | The account ID, the key's access and whether the feature is available |
| Validation error | Required fields, allowed values, amounts, parent IDs and incompatible settings |
| Resource not found | The exact ID, the selected account and the resource type |
| Conflict | An idempotency key reused with a different body, or an outdated revision |
| Request too large | The endpoint's size or operation-count limit |
| Rate limited | The retry guidance returned, and the shared limits |
OpenAI's partner guide says some features must be enabled for each client account, and to contact your OpenAI partner representative if a brand update returns 403, the pixel or Conversions API key endpoints return 404, or campaign creation returns 403 with "Conversion bidding is not enabled". If a Bulk API endpoint returns 404, ask your OpenAI account team to confirm access.
Sources: OpenAI's API overview, troubleshooting, partner setup and Bulk API pages, checked on 29 Oct 2026.
Recent ChatGPT Ads API changes
The latest entries in the changelog of OpenAI's API overview, checked on 29 Oct 2026.
| Date | Change |
|---|---|
| 26 Oct 2026 | Enabled accounts can create ads with 4 to 6 square images that share one title, body and destination URL. |
| 30 Sep 2026 | Selectable click and view attribution windows on the four Insights endpoints, defaulting to 30-day click and 1-day view. |
| 10 Sep 2026 | Separate web platform targeting for desktop, iOS and Android browsers. |
| 9 Sep 2026 | Daily account spending limits for ad accounts on postpaid invoice billing. |
| 25 Aug 2026 | Add, remove, replace and merge operations for custom audiences. |
| 19 Aug 2026 | More customer-matching fields in the Pixel and the Conversions API, and Android GAID support in the Conversions API. |
Source: the changelog in OpenAI's API overview.
Using the ChatGPT Ads API for clients
Each Ads API key is scoped to one ad account, so agencies and API partners use the key of each client's ad account. OpenAI's API Partner Setup guide works in this order: confirm account access, add a brand icon, configure conversions, then create campaigns and ads. Brand updates, pixel management and Conversions API keys must be enabled for each client account.
More: ChatGPT ads for agencies and become a partner. Source: OpenAI's API Partner Setup guide.
Ad operations data and competitive intelligence are different
The Ads API manages your own campaigns and reporting. ChatGPT Ad Library observes public-facing sponsored placements to help researchers compare advertisers, creatives, niches, and trigger prompts. Its corpus is a captured sample, not OpenAI campaign-account data.
FAQ
ChatGPT Ads API, answered
The questions people actually ask.
Where is the OpenAI Ads API documentation?
At developers.openai.com/ads. It includes an overview, a quickstart, an API reference, an OpenAPI spec and a changelog whose first dated entry is 3 Jun 2026.
How can I get ChatGPT Ads API access?
You need an ad account in Ads Manager. Create an Advertiser API key on its Settings page; each key is scoped to one ad account. Requests go to https://api.ads.openai.com/v1, within 600 requests a minute per endpoint and 1,200 a minute overall.
Can I automate campaign creation without the API?
Yes. OpenAI officially supports bulk upload using its campaign schema template. The workflow can create campaigns, ad groups, and ads at scale, and Ads Manager provides CSV reporting exports.
Is the regular OpenAI API the same as the Ads API?
No. The OpenAI model API at platform.openai.com is for building with OpenAI models and tools. Ads Manager is a separate advertising product with separate access, roles, billing, and API keys.
Can I get ChatGPT ads reporting through the API?
Yes. Four Insights endpoints return results for the ad account, campaigns, ad groups and ads, including impressions, clicks, spend, CTR, CPC, CPM and conversions. Conversions use a 30-day click and 1-day view attribution window unless you choose otherwise, and non-hourly delivery reporting, other than product reports, covers the most recent 365 days. More: ChatGPT ads measurement.
Is there a bulk API for ChatGPT ads?
Yes, but it is in limited preview and must be enabled for the ad account. A job takes up to 1,000 create or update operations. Without it, use the bulk upload template in Ads Manager.
Does ChatGPT Ad Library offer an ad intelligence API?
This site currently provides a public web library and internal data routes for its product. It does not advertise a supported public commercial API contract on this page. Contact the library team if you need structured competitive-intelligence access.
Need the buying interface?
See current Ads Manager access, countries, setup, and capabilities.