Targeting, copy and names

← ChatGPT ads Endpoints: GET /chatgpt-ad-groups/{ad_group_id}, PATCH /chatgpt-ad-groups/{ad_group_id}, POST /chatgpt-ad-groups/{ad_group_id}/targeting, POST /chatgpt-ads/{ad_id}/copy Permissions: retrieve with chatgpt_ads:read, rename with chatgpt_ads:update, rewrites with chatgpt_ads:generate Everything after generation is free: rewrite the targeting for a whole group, rewrite one ad’s title and body, or rename a group to keep a growing library readable in the app.

Retrieve the group

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

The group carries its ads, shared targeting and progress. See Create an ad group for the full shape.

Rewrite a group’s targeting

Context hints (hints) and negative phrases (phrases) steer every ad in the group. Rewrite either list for the whole group, free:

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" }'

200 OK returns the group with its new context_hints (or negative_phrases for scope: "phrases").

string

required

The group whose targeting to rewrite.

string

required

Which list to rewrite: hints (context hints) or phrases (negative phrases).

Rewrite one ad’s copy

Write a new title and body for one ad, free. Its image stays:

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

200 OK returns the ad’s group, with the new copy on the ad.

Rename a group

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" }'

200 OK returns the renamed group. The name is 1 to 120 characters and is what the app shows in the group list.

Errors

Status	Code	Meaning
`404`	`ad_group_not_found`, `ad_not_found`	Not available to you
`422`	`invalid_request`	A `scope` outside `hints` or `phrases`, or an empty name

See Errors and retries for the error format.

Get started

Set up

Ad campaigns

Listing images

Photoshoots

ChatGPT ads

UGC videos

Core concepts

Help

Targeting, copy and names

Retrieve the group

Rewrite a group’s targeting

Rewrite one ad’s copy

Rename a group

Errors

​Retrieve the group

​Rewrite a group’s targeting

​Rewrite one ad’s copy

​Rename a group

​Errors

Retrieve the group

Rewrite a group’s targeting

Rewrite one ad’s copy

Rename a group

Errors