← All docs
Setup Guide

Connect ChatGPT Ads to DidYouSEO

Add your ChatGPT Ads accounts to DidYouSEO with an API key from Ads Manager. Then see spend, clicks and conversions for each account in one list. You can also ask about your ads in ChatGPT, Claude or Cursor.

What you need: a DidYouSEO account, access to at least one ChatGPT Ads account at ads.openai.com, and permission to create API keys in that account. DidYouSEO only reads your ad data.

1Create an API key in Ads Manager

  1. Open ads.openai.com.
  2. Go to Settings → General.
  3. In API Keys, create a key. Give it a name, for example "DidYouSEO".
  4. Copy the key.

Each key gives access to one ad account. If you manage ads for clients, switch to each client account in Ads Manager. Then create one key in each account.

2Paste the key in DidYouSEO

  1. In DidYouSEO, go to Settings → ChatGPT Ads.
  2. Paste the key in the box. To add more accounts, paste one key on each line.
  3. Click Connect account. With more keys, the button shows the number of accounts.

DidYouSEO sends each key to OpenAI to check it. Then it stores the key encrypted. DidYouSEO does not show the key again. The result shows the name of each ad account, or the reason that a key did not work.

3Check the site for each ad account

Each ad account has a business website in Ads Manager. DidYouSEO links the ad account to the site in My Sites with the same website. Each ad account shows its site in a Site list.

  • If the site is not correct, select a different site in the list.
  • If no site matches, the list shows No site. Select the site, or keep No site.
  • A site does not need an ad account. Sites without ads do not show in this list.

Each ad account shows its spend, clicks and conversions for the last 28 days. If no campaign ran in that period, the card shows "No ads ran in the last 28 days."

4Ask your AI assistant about your ads

Connect the DidYouSEO MCP server to Claude, ChatGPT or Cursor. Use the same DidYouSEO account. The setup for each assistant is on the MCP server page.

https://didyouseo.com/mcp

Then ask in plain language, for example:

List my ChatGPT ad accounts with spend for the last 7 days.

The assistant uses three tools:

ToolWhat it gives
list_chatgpt_ad_accountsAll connected ad accounts, with the site and the results of each account.
get_chatgpt_ads_performanceThe report for one ad account: totals, top campaigns and daily results.
query_chatgpt_adsA custom report by campaign, ad group or ad. You can split the results by country, device, platform or product.

More tools and prompts are on the ChatGPT Ads MCP page.

Limits

  • Each API key gives access to one ad account.
  • You can paste up to 25 keys at the same time, and up to 100 keys in one hour.
  • The Ads API does not give conversions when you split results by platform or by product.
  • The Ads API does not give conversions in monthly rows. Use daily rows or one total.
  • A custom report can cover up to 365 days.

Troubleshooting

  • "This is not a ChatGPT Ads API key. Copy the full key from Ads Manager." The text in the box is not a complete key. Copy the key again from Ads Manager.
  • "OpenAI did not accept this key. Make sure that you copied the full key and that it is active." Somebody deleted the key in Ads Manager, or a part of the key is missing. Create a new key in Ads Manager. Then paste it.
  • "This key stopped working. Remove it and add a new key from Ads Manager." Somebody deleted the key in Ads Manager, or your access to the ad account stopped. Remove the ad account in DidYouSEO. Then add a new key.
  • "Too many keys in one hour. Wait one hour, then try again." You added more than 100 keys in one hour. Wait one hour.
  • "ChatGPT Ads is not connected to your DidYouSEO account." Your AI assistant uses a DidYouSEO account with no ad accounts. Add an ad account in Settings → ChatGPT Ads. Use the same DidYouSEO account in the assistant.
  • "More than one ad account is connected." Tell the assistant which website or ad account to use. Or ask it to list all ad accounts first.

Frequently asked questions

Does DidYouSEO change my ChatGPT ads?

No. DidYouSEO only reads reporting data. It does not create, change, pause or pay for ads.

Why does DidYouSEO need an API key?

OpenAI gives reporting tools access to an ad account through an API key that the advertiser creates in Ads Manager. OpenAI does not offer read-only keys at this time. DidYouSEO stores each key encrypted and uses it only to read reports.

Can I connect more than one ad account?

Yes. Each API key gives access to one ad account. Add one key for each ad account. You can paste up to 25 keys at the same time.

Which plans include ChatGPT Ads?

All plans include the ChatGPT Ads connection, including Free. In AI assistants, the Free plan shows a shorter preview of the results. Paid plans show the full results.

How do I stop DidYouSEO from reading my ad data?

Remove the ad account in Settings → ChatGPT Ads. To stop all access to the key, also delete the key in Ads Manager under Settings → General → API Keys.

See every ChatGPT Ads account in DidYouSEO

Connect one account or all your clients. Read the results in one list, or ask your AI assistant.