Quickstart

This guide takes you from an API key to a working product request.

Get an API key

Ask your LocalAds contact to provision an organization API key with the products:create and products:read permissions.Store it in an environment variable. The full key is shown only once.

export LOCALADS_API_KEY="lads_your_key"

Choose a brand

List the brands available to the organization and copy the brand id:

curl https://makelocalads.com/api/v1/brands \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

Create a product

If the product image is a local file, upload it first:

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

Copy the returned url into image_urls below. If the image already has a public HTTPS URL, you can use that URL directly.

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/serum-front.jpg"
    ]
  }'

const response = await fetch(
  "https://makelocalads.com/api/v1/products",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.LOCALADS_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      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/serum-front.jpg"],
    }),
  },
);

if (!response.ok) {
  throw new Error(await response.text());
}

const product = await response.json();
console.log(product.id);

Check the response

A request containing product images or a source URL returns 202 Accepted. Retrieve the product until status becomes ready:

{
  "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": "https://example.com/products/serum",
  "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"
}

The response also includes a Location header containing the product URL.

Next step

Follow Manage products to list, update, and delete products, or open the API reference tab.

Last modified on August 5, 2026

Start here

Build with LocalAds

Help

Next step

​Next step

Next step