Manage products

Products contain the customer-facing information and images LocalAds uses in creative workflows. Every product belongs to a brand.

Upload a local product image

If the image is on a computer or private server, upload it first. Send one file at a time using multipart form data and keep the returned url. The endpoint accepts JPG, PNG, WebP, HEIC, and HEIF images up to 10 MB.

curl --request POST \
  --url "https://makelocalads.com/api/v1/uploads/images" \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --form "file=@/path/to/serum-front.jpg"

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append(
  "file",
  new Blob([await readFile("/path/to/serum-front.jpg")], { type: "image/jpeg" }),
  "serum-front.jpg",
);

const response = await fetch(
  "https://makelocalads.com/api/v1/uploads/images",
  {
    method: "POST",
    headers: { Authorization: `Bearer ${process.env.LOCALADS_API_KEY}` },
    body: form,
  },
);

if (!response.ok) throw new Error(await response.text());
const uploadedImage = await response.json();

{
  "url": "https://assets.makelocalads.com/public-api/example/images/3a4c79b4-999b-48c2-a77c-1db08b884908.jpg",
  "content_type": "image/jpeg",
  "width": 1600,
  "height": 1600,
  "size_bytes": 428310
}

Use url in the product’s image_urls array. To add several images, repeat the upload once per file. Do not send base64 or a JSON data URL. If an image is already available at a public HTTPS URL, you can place that URL directly in image_urls; LocalAds will validate it and keep its own copy.

Create a product

brand_id and name are required. Get the brand ID from GET /brands. Add description to give creative workflows customer-facing product context, and add image_urls when the product will be used for image generation. You can provide source_url instead of name to add a product from its page. Requests with a URL or image URLs return 202 Accepted with status: "processing". Retrieve the product until its status is ready before starting creative work. Idempotency-Key is optional on creation and safely replays a repeated request. Do not combine source_url and image_urls in one request.

curl --request POST \
  --url https://makelocalads.com/api/v1/products \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "brand_id": "1423f915-beca-4c53-a5e4-7c8c99537be9",
    "name": "Hydrating Face Serum",
    "description": "A lightweight daily serum that hydrates dry skin.",
    "kind": "skincare",
    "image_urls": ["https://assets.makelocalads.com/public-api/example/images/3a4c79b4-999b-48c2-a77c-1db08b884908.jpg"]
  }'

List products

curl "https://makelocalads.com/api/v1/products?brand_id=1423f915-beca-4c53-a5e4-7c8c99537be9&limit=20" \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

The response uses cursor pagination:

{
  "data": [
    {
      "id": "a1516a75-9be5-461a-93af-c1896a0a3127",
      "brand_id": "1423f915-beca-4c53-a5e4-7c8c99537be9",
      "name": "Hydrating Face Serum",
      "description": "A lightweight daily serum that hydrates dry skin.",
      "kind": "skincare",
      "source_url": null,
      "image_urls": ["https://cdn.example.com/serum-front.jpg"],
      "status": "processing",
      "created_at": "2026-07-24T14:30:00.000Z",
      "updated_at": "2026-07-24T14:30:00.000Z"
    }
  ],
  "next_cursor": null
}

When next_cursor is not null, pass it unchanged in the next request:

curl "https://makelocalads.com/api/v1/products?brand_id=1423f915-beca-4c53-a5e4-7c8c99537be9&limit=20&cursor=CURSOR" \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

Retrieve a product

curl https://makelocalads.com/api/v1/products/a1516a75-9be5-461a-93af-c1896a0a3127 \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

Resources outside the API key’s organization return 404, just like missing resources.

List photoshoot creatives

Retrieve the completed photoshoot images generated for a product:

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

{
  "data": [
    {
      "id": "19025a65-5395-41c9-af90-d7cca7fb6421",
      "type": "photoshoot",
      "photoshoot_id": "e8766ffd-66f7-47c9-86bc-0d93e6868d06",
      "image_url": "https://cdn.example.com/generated-shot-1.png",
      "width": 1024,
      "height": 1024,
      "created_at": "2026-07-25T15:00:04.000Z"
    }
  ],
  "next_cursor": null
}

The endpoint returns only completed, customer-facing photoshoot outputs. It does not return templates, moodboards, failed attempts, or intermediate assets. Use next_cursor unchanged to retrieve the next page.

Update a product

Send only the fields that should change:

curl --request PATCH \
  --url https://makelocalads.com/api/v1/products/a1516a75-9be5-461a-93af-c1896a0a3127 \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Hydrating Face Serum — 30 ml",
    "description": "A lightweight daily serum for lasting hydration.",
    "image_urls": [
      "https://cdn.example.com/serum-front.jpg",
      "https://cdn.example.com/serum-side.jpg"
    ]
  }'

description and the other supplied fields replace their current values. Send description: null to clear the description. image_urls replaces the complete image list; send an empty array to clear the images. Supplying new image URLs returns 202 Accepted; retrieve the product until its status is ready.

Delete a product

curl --request DELETE \
  --url https://makelocalads.com/api/v1/products/a1516a75-9be5-461a-93af-c1896a0a3127 \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

A successful deletion returns 204 No Content. The product and its related resources are no longer available through the API, active generation stops, and subsequent requests for the product return 404 Not Found. Deletion cannot be reversed through the public API.

Last modified on August 24, 2026

Start here

Build with LocalAds

Help

Upload a local product image

Create a product

List products

Retrieve a product

List photoshoot creatives

Update a product

Delete a product

​Upload a local product image

​Create a product

​List products

​Retrieve a product

​List photoshoot creatives

​Update a product

​Delete a product

Upload a local product image

Create a product

List products

Retrieve a product

List photoshoot creatives

Update a product

Delete a product