Manage products

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

Create a product

brand_id and name are required. Get the brand ID from GET /brands. Add image_urls when the product will be used for image generation.

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",
    "kind": "skincare",
    "image_urls": ["https://cdn.example.com/serum-front.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",
      "kind": "skincare",
      "source_url": null,
      "image_urls": ["https://cdn.example.com/serum-front.jpg"],
      "status": "ready",
      "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.

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",
    "image_urls": [
      "https://cdn.example.com/serum-front.jpg",
      "https://cdn.example.com/serum-side.jpg"
    ]
  }'

image_urls replaces the complete image list. To clear the images, send an empty array.

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. Deletion is permanent and also removes resources owned by that product.

Start here

Build with LocalAds

Help

Create a product

List products

Retrieve a product

Update a product

Delete a product

​Create a product

​List products

​Retrieve a product

​Update a product

​Delete a product

Create a product

List products

Retrieve a product

Update a product

Delete a product