Docs — ChatGPT Ads

Start here

Introduction

The ChatGPT Ads API on AdScrape gives you the same data the dashboard renders, exposed as a small REST surface. Every call returns JSON with consistent envelopes — there are no XML or form-encoded responses. Preview API specification for ChatGPT ads.

REST + JSON
UTF-8 JSON in/out. Endpoint shapes are stable and forward-compatible.
New ad surface
Monitor promotions inside ChatGPT as the catalog matures.
Net-new inventory
Be early on a platform the rest of the industry hasn't indexed yet.
Preview pricing
Endpoints reserved — not billable until GA. 10 free credits at launch.
Same auth as Meta
One AdScrape key covers Meta, YouTube, Google, LinkedIn, and ChatGPT.
Waitlist
Pre-launch — endpoints return 503 until your account is allowlisted.

0 → first response in 60 seconds

Quickstart

1. Join the waitlist. Sign up — accounts are allowlisted in cohorts as the ad inventory grows.
2. Create a key. Settings → API Keys → Create. The same key works across every AdScrape surface.
3. Send a probe call. /chatgpt/search with a generic query returns the response envelope so you can wire up your handlers before GA.

bash

curl -X POST https://api.adscrape.in/api/v1/chatgpt/search \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query":"openai","max_results":10}'

Auth

Authentication

Same authentication as every other AdScrape surface — pass X-API-Key on every request. Bearer JWT also works for dashboard sessions. Manage keys at Settings → API Keys.

bash

curl -X POST https://api.adscrape.in/api/v1/chatgpt/search \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"query":"openai"}'

Treat keys like passwords. Anything that calls this API with your key spends your credits. Rotate from Settings → API Keys if you suspect a leak.

Pricing

Credits & pricing

ChatGPT routes are reserved but not billable during preview. Every call currently returns a 503 with code: "preview_not_allowlisted" until your account is enabled. At GA, pricing will match the rest of the AdScrape per-ad model.

EndpointPer-call rateUSDNotes

POST /api/v1/chatgpt/search
preview
— (free at GA: $0.05/ad)
Reserved during preview. Returns 503 until allowlisted.
GET /api/v1/chatgpt/ads/{id}
preview
— (free at GA)
Cache reads, free at GA.

Throughput

Rate limits

Caps follow the rest of AdScrape. During preview, allowlisted accounts get the Free-tier cap regardless of plan — billing kicks in at GA.

PlanReq / minNotes

Preview (all)
30
Same cap for everyone until GA.
Free (GA)
30
Future GA cap.
Starter (GA)
60
Future GA cap.
Growth (GA)
120
Future GA cap.

Error model

Error responses

Errors share one envelope. During preview most non-allowlisted calls return 503 — wire your handlers now so GA is a flip-flag.

StatusReasonMeaning

400validation_error
Bad body. Detail names the field.
401missing_key
No X-API-Key header and no valid JWT cookie.
404ad_not_found
No ad with that id in your cache.
429rate_limited
Per-minute cap exceeded. Honour Retry-After.
503preview_not_allowlisted
Your account isn't in the preview cohort yet — join the waitlist.

Endpoint (preview)

Search inventory

POST/api/v1/chatgpt/search preview · free

Search the ChatGPT ad inventory by free-text query. Response envelope is final — payloads will be more populated as inventory grows.

Request body

FieldTypeDescription

queryrequired
string
1–80 chars. Free-text query against advertiser, ad title, and body.
max_resultsoptional
integer
Max ads returned (1–50). Playground clamps to 5.Defaults to 10.
session_tokenoptional
string
Cursor from the previous response — pagination is supported even in preview.

Request

bash

curl -X POST https://api.adscrape.in/api/v1/chatgpt/search \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"query":"openai","max_results":10}'

Response

application/json200 OK

{
  "summary": { "count": 4, "query": "openai", "preview": true },
  "ads": [
    {
      "ad_id": "gpt_ad_001",
      "advertiser": "OpenAI",
      "surface": "chatgpt-conversation",
      "placement": "sidebar",
      "headline": "Try ChatGPT Plus — Faster, smarter, $20/mo",
      "destination_url": "https://chatgpt.com/upgrade",
      "first_seen": "2026-04-22T11:00:00Z"
    }
  ],
  "session_token": "gpt_sess_x9y8z7",
  "has_more": false
}

Endpoint (preview)

Ad detail

GET/api/v1/chatgpt/ads/{id} preview · free

Full single-ad record. Reads from your cache after a /chatgpt/search call has surfaced the ad. Returns 404 for unknown ids.

Request

bash

curl https://api.adscrape.in/api/v1/chatgpt/ads/gpt_ad_001 \
  -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Response

application/json200 OK

{
  "ad_id": "gpt_ad_001",
  "advertiser": "OpenAI",
  "surface": "chatgpt-conversation",
  "placement": "sidebar",
  "headline": "Try ChatGPT Plus — Faster, smarter, $20/mo",
  "body": "Unlock GPT-5 and priority access during peak times.",
  "cta": "Upgrade",
  "destination_url": "https://chatgpt.com/upgrade",
  "media_url": null,
  "first_seen": "2026-04-22T11:00:00Z",
  "last_seen": "2026-05-15T08:30:00Z",
  "preview": true
}

Next steps

The dashboard, your keys, and your billing live one tab away.

API keysCreate, rotate, scope by RPM PlaygroundTry this API in 60s, no key required Billing & creditsPlans, top-ups, ledger ChatGPT overviewBack to the platform tour Usage analyticsPer-key, per-endpoint, per-day ContactSales, support, or partnerships

Looking for the master reference? AdScrape's full cross-platform docs cover billing, webhooks, and shared schemas at /docs.

curl -X POST https://api.adscrape.in/api/v1/chatgpt/search \ -H "X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ -H "Content-Type: application/json" \ -d '{"query":"openai","max_results":10}'

{ "summary": { "count": 4, "query": "openai", "preview": true }, "ads": [ { "ad_id": "gpt_ad_001", "advertiser": "OpenAI", "surface": "chatgpt-conversation", "placement": "sidebar", "headline": "Try ChatGPT Plus — Faster, smarter, $20/mo", "destination_url": "https://chatgpt.com/upgrade", "first_seen": "2026-04-22T11:00:00Z" } ], "session_token": "gpt_sess_x9y8z7", "has_more": false }

{ "ad_id": "gpt_ad_001", "advertiser": "OpenAI", "surface": "chatgpt-conversation", "placement": "sidebar", "headline": "Try ChatGPT Plus — Faster, smarter, $20/mo", "body": "Unlock GPT-5 and priority access during peak times.", "cta": "Upgrade", "destination_url": "https://chatgpt.com/upgrade", "media_url": null, "first_seen": "2026-04-22T11:00:00Z", "last_seen": "2026-05-15T08:30:00Z", "preview": true }

Build with ChatGPT ads.

Introduction

Quickstart

Authentication

Credits & pricing

Rate limits

Error responses

Search inventory

Ad detail

Next steps

Build with ChatGPT ads.

Introduction

Quickstart

Authentication

Credits & pricing

Rate limits

Error responses

Search inventory

Ad detail

Next steps