Creatives

Every image and video LocalAds generates is a creative. GET /creatives lists the finished ones across every workflow: campaign ads, photoshoot photos, videos, ChatGPT ads and listing images, newest first, filterable by product, campaign or type. It is the one endpoint for “everything this organization has made”. Permission: products:read

List creatives

curl "https://makelocalads.com/api/v1/creatives?product_id=a1516a75-9be5-461a-93af-c1896a0a3127&limit=50" \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

{
  "data": [
    {
      "id": "4f52bad2-2da3-4b36-93ac-03788f35daca",
      "type": "campaign",
      "status": "completed",
      "brand_id": "1423f915-beca-4c53-a5e4-7c8c99537be9",
      "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
      "campaign_id": "84b92447-425f-4d2a-9ba1-7d67bf802332",
      "photoshoot_id": null,
      "image_url": "https://cdn.example.com/generated-ad-1.png",
      "video_url": null,
      "width": 1024,
      "height": 1024,
      "caption": null,
      "created_at": "2026-07-24T15:00:04.000Z"
    }
  ],
  "next_cursor": null
}

Filters

Parameter	Meaning
`product_id`	Only creatives for this product
`campaign_id`	Only creatives from this campaign
`type`	`campaign`, `photoshoot`, `video`, `chatgpt_ad`, or `amazon_listing`
`limit`	Page size, 1 to 100. Defaults to `20`
`cursor`	The opaque cursor from the previous page

The list returns only completed, customer-facing creatives. Use next_cursor unchanged to get the next page.

Retrieve one creative

GET /creatives/{creative_id} returns one creative in any status, so it also works as a per-item progress check. Its URLs are present only once it is completed:

curl https://makelocalads.com/api/v1/creatives/4f52bad2-2da3-4b36-93ac-03788f35daca \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

A type of other can appear on a single creative’s retrieval: it covers types the list endpoint does not filter by. Nothing you start returns it. The same shapes power the workflow-specific lists: a product’s photoshoot photos (GET /products/{product_id}/creatives) and a campaign’s creatives appear here too, with their source ids (campaign_id, photoshoot_id) set.

Get started

Set up

Ad campaigns

Listing images

Photoshoots

ChatGPT ads

UGC videos

Core concepts

Help

List creatives

Filters

Retrieve one creative

​List creatives

​Filters

​Retrieve one creative

List creatives

Filters

Retrieve one creative