LocalAds API

The LocalAds API does what the LocalAds app does: ad campaigns, Amazon listing images, product photoshoots, ChatGPT ads and videos, from the products you add. It offers the same choices as the app, so an integration gets the same results a person would. It works audience-first: every product gets its audiences automatically, and campaigns and videos are written for the one you pick.

Make your first request

Go from an API key to finished photos in about five minutes.

Get an API key

Create a key under Settings > API keys in the app.

Make a request

Every request is HTTPS with a bearer key and returns JSON. A generation request answers 202 Accepted with the job’s id and a Location header, then runs in the background:

curl --request POST \
  --url https://makelocalads.com/api/v1/photoshoots \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
    "quick_shoot": { "count": 1 },
    "max_credits": 1
  }'

curl --request POST \
  --url https://makelocalads.com/api/v1/campaigns \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
    "blueprint_id": "viral-pattern-interrupt",
    "audience_id": "0f0c5a4e-54f7-4f0e-9d4e-1a8c3a6b5d11",
    "creative_count": 10,
    "max_credits": 20
  }'

{
  "id": "e8766ffd-66f7-47c9-86bc-0d93e6868d06",
  "brand_id": "1423f915-beca-4c53-a5e4-7c8c99537be9",
  "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
  "template_id": null,
  "credits_charged": 1,
  "status": "queued",
  "outputs": [
    {
      "id": "19025a65-5395-41c9-af90-d7cca7fb6421",
      "position": 1,
      "status": "queued",
      "image_url": null,
      "width": null,
      "height": null,
      "caption": null
    }
  ],
  "created_at": "2026-07-24T15:00:00.000Z",
  "updated_at": "2026-07-24T15:00:00.000Z"
}

Poll the job until its status is completed, then read the results from the response. Every command to copy is in the Quickstart.

Choose what to make

Ad campaigns

Static ad creatives from a recipe, several ad types, or a brief.

Listing images

Amazon listing images, one rendered idea per image slot.

Photoshoots

Finished product photos from a Quick Shoot, a template, or a moodboard.

ChatGPT ads

Chat-card ads with a shared landing page, price and targeting.

Videos

Videos from any recipe (UGC voiceover, Pixar style, podcast, song…), or animate a finished photo.

Build for production

Jobs and lifecycle

What runs asynchronously, and the status each job moves through.

Credits and spending

What each operation costs, and how to cap what a request can spend.

Errors and retries

The problem format, error codes, and when to retry safely.

Call the API from your server with an organization API key. Never put a key in browser or mobile code. See Authentication.

Get started

Set up

Ad campaigns

Listing images

Photoshoots

ChatGPT ads

Videos

Core concepts

Help

Make your first request

Get an API key

Make a request

Choose what to make

Ad campaigns

Listing images

Photoshoots

ChatGPT ads

Videos

Build for production

Jobs and lifecycle

Credits and spending

Errors and retries

Make your first request

Get an API key

​Make a request

​Choose what to make

Ad campaigns

Listing images

Photoshoots

ChatGPT ads

Videos

​Build for production

Jobs and lifecycle

Credits and spending

Errors and retries

Make a request

Choose what to make

Build for production