Create ChatGPT ads

A ChatGPT ad is a chat card: an image, a short title and a body line, linking to your landing page. Ads are made in ad groups, matching OpenAI Ads Manager: every ad in a group shares its landing page, price, context hints and negative phrases. The API offers the same choices as the ChatGPT Ads page. Each ad costs 1 credit. Rewriting copy or targeting is free.

Before you start

You need:

an API key with chatgpt_ads:generate, chatgpt_ads:read, and chatgpt_ads:update to rename groups
a product in LocalAds
one credit per ad

Create an ad group

curl --request POST \
  --url https://makelocalads.com/api/v1/chatgpt-ad-groups \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: chatgpt-group-77" \
  --data '{
    "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
    "target_url": "https://shop.example.com/products/linen-throw",
    "angle": "The gift for people who have everything",
    "price": "$89",
    "ad_count": 3
  }'

const response = await fetch("https://makelocalads.com/api/v1/chatgpt-ad-groups", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOCALADS_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "chatgpt-group-77",
  },
  body: JSON.stringify({
    product_id: "a1516a75-9be5-461a-93af-c1896a0a3127",
    target_url: "https://shop.example.com/products/linen-throw",
    angle: "The gift for people who have everything",
    price: "$89",
    ad_count: 3,
  }),
});

const group = await response.json();

Field	Values	Default
`target_url`	the landing page, required	none
`angle`	optional direction, up to 2,000 characters; also names the group	none
`price`	optional, up to 100 characters	none
`ad_count`	`1`, `3`, `5`, `8`	`3`
`max_credits`	refuse if the batch would cost more	none

LocalAds returns 202 Accepted with the group. Its id is the ad group ID.

Retrieve the ads

curl https://makelocalads.com/api/v1/chatgpt-ad-groups/2b8f6d4e-1a3c-4e5f-9b7d-0c2e4f6a8b1d \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

{
  "id": "2b8f6d4e-1a3c-4e5f-9b7d-0c2e4f6a8b1d",
  "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
  "name": "Linen throw: The gift for people who have everything",
  "target_url": "https://shop.example.com/products/linen-throw",
  "angle": "The gift for people who have everything",
  "price": "$89",
  "context_hints": ["thoughtful housewarming gifts", "cozy home upgrades", "gifts for parents"],
  "negative_phrases": ["free", "cheap blanket"],
  "status": "completed",
  "credits_charged": 3,
  "ads": [
    {
      "id": "8e1c3a5b-7d9f-4b2e-a6c8-0d2f4e6a8c1b",
      "status": "completed",
      "position": 0,
      "title": "Gift they will use daily",
      "body": "Stonewashed linen, softer every wash.",
      "image_url": "https://cdn.example.com/chatgpt/throw-1.png",
      "width": 1024,
      "height": 1024
    }
  ],
  "created_at": "2026-09-25T10:00:00.000Z",
  "updated_at": "2026-09-25T10:00:00.000Z"
}

Poll with backoff until status is completed or failed. title, body, context_hints and negative_phrases are filled in once the copy is written.

Generate more ads in a group

New ads join the group and reuse its landing page, price, direction, name and targeting, so only the count is chosen:

curl --request POST \
  --url https://makelocalads.com/api/v1/chatgpt-ad-groups/2b8f6d4e-1a3c-4e5f-9b7d-0c2e4f6a8b1d/ads \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "ad_count": 3 }'

Edit a group

Rename it:

curl --request PATCH \
  --url https://makelocalads.com/api/v1/chatgpt-ad-groups/2b8f6d4e-1a3c-4e5f-9b7d-0c2e4f6a8b1d \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "name": "Linen throw, gifting" }'

Rewrite its context hints (hints) or negative phrases (phrases) for every ad at once:

curl --request POST \
  --url https://makelocalads.com/api/v1/chatgpt-ad-groups/2b8f6d4e-1a3c-4e5f-9b7d-0c2e4f6a8b1d/targeting \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "scope": "hints" }'

Rewrite one ad’s title and body:

curl --request POST \
  --url https://makelocalads.com/api/v1/chatgpt-ads/8e1c3a5b-7d9f-4b2e-a6c8-0d2f4e6a8c1b/copy \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

Each returns the updated group.

Errors

Status	Code	Meaning
`404`	`product_not_found`, `ad_group_not_found`, `ad_not_found`	Not available to you
`422`	`insufficient_credits`	Not enough credits for the batch. Nothing was charged
`422`	`credit_limit_exceeded`	The batch would cost more than `max_credits`
`422`	`plan_required`	Your plan does not include generation

Start here

Build with LocalAds

Help

Before you start

Create an ad group

Retrieve the ads

Generate more ads in a group

Edit a group

Errors

​Before you start

​Create an ad group

​Retrieve the ads

​Generate more ads in a group

​Edit a group

​Errors

Before you start

Create an ad group

Retrieve the ads

Generate more ads in a group

Edit a group

Errors