Brands

An organization API key can access multiple brands. Every product belongs to a brand, so listing brands is usually the first call of an integration. Endpoints: GET and POST https://makelocalads.com/api/v1/brands, PATCH and DELETE https://makelocalads.com/api/v1/brands/{brand_id} Permissions: list with products:read, create with products:create, update with products:update, delete with products:delete

Open in LocalAds

The brands and products of your workspace, on the app’s home screen.

List brands

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

{
  "data": [
    {
      "id": "1423f915-beca-4c53-a5e4-7c8c99537be9",
      "name": "Example Beauty",
      "slug": "example-beauty",
      "website_url": "https://example.com",
      "created_at": "2026-07-20T10:00:00.000Z",
      "updated_at": "2026-07-20T10:00:00.000Z",
      "product_count": 12
    }
  ]
}

Each brand comes with product_count, its number of products (variants and deleted products are not counted). Use the returned id as brand_id when creating a product, or when listing products and templates.

Sort and filter

Sorting and filtering happen on the server, so common questions take one request:

Question	Request
Which brand has the most products?	`?sort=product_count&order=desc&limit=1`
Which brands have no products yet?	`?has_products=false`
What are my five newest brands?	`?sort=created_at&order=desc&limit=5`
Is there a brand called Quenzy?	`?name_contains=quenzy`

curl "https://makelocalads.com/api/v1/brands?sort=product_count&order=desc&limit=1" \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

Parameter	Values	Default
`sort`	`name`, `product_count`, `created_at`	`name`
`order`	`asc`, `desc`	`asc`
`limit`	1 to 200	all brands
`has_products`	`true`, `false`	both
`name_contains`	Any text, matched ignoring case	none

An unknown value returns 400 invalid_request.

Create a brand

If the brand you need is not in the list, create it. This is the first call for a website LocalAds has not seen before.

curl --request POST \
  --url https://makelocalads.com/api/v1/brands \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: 8f0a1c2e-quenzy-setup" \
  --data '{
    "name": "Quenzy",
    "website_url": "https://thequenzy.com",
    "selling_countries": ["IN"]
  }'

const response = await fetch("https://makelocalads.com/api/v1/brands", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOCALADS_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "8f0a1c2e-quenzy-setup",
  },
  body: JSON.stringify({
    name: "Quenzy",
    website_url: "https://thequenzy.com",
    selling_countries: ["IN"],
  }),
});

const brand = await response.json();

import os
import requests

response = requests.post(
    "https://makelocalads.com/api/v1/brands",
    headers={
        "Authorization": f"Bearer {os.environ['LOCALADS_API_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": "8f0a1c2e-quenzy-setup",
    },
    json={
        "name": "Quenzy",
        "website_url": "https://thequenzy.com",
        "selling_countries": ["IN"],
    },
)

brand = response.json()

{
  "id": "9f2b7c41-58a0-4c3e-9d61-2f0c8b7d4a15",
  "name": "Quenzy",
  "slug": "quenzy",
  "website_url": "https://thequenzy.com",
  "created_at": "2026-08-12T10:00:00.000Z",
  "updated_at": "2026-08-12T10:00:00.000Z"
}

Input fields

string

required

The brand’s name, 1 to 200 characters.

string

The brand’s own site, as a URL. LocalAds uses it to fetch the logo, and to keep one brand per website.

array

ISO 3166-1 alpha-2 country codes where the brand sells, up to 50. Defaults to an empty list.

Complete JSON schema

{
  "type": "object",
  "additionalProperties": false,
  "required": ["name"],
  "properties": {
    "name": { "type": "string", "minLength": 1, "maxLength": 200 },
    "website_url": { "type": ["string", "null"], "format": "uri" },
    "selling_countries": {
      "type": "array",
      "maxItems": 50,
      "items": { "type": "string", "minLength": 2, "maxLength": 2 }
    }
  }
}

One brand per website

Posting a second brand for a domain that already has one returns 409 brand_website_exists with the existing brand’s name, so retrying a setup script does not litter the account with duplicates. Send an Idempotency-Key to make a network retry safe as well; see Idempotent requests.

Status	Code	Meaning
409	`brand_website_exists`	A brand for this website already exists. List brands and reuse its ID
422	`brand_limit_reached`	The plan’s brand allowance is used up

Update a brand

Rename a brand or change its website or selling countries. Only the fields you send change; selling_countries replaces the whole list. A new website refreshes the brand’s logo, and "website_url": null removes it.

curl --request PATCH \
  --url https://makelocalads.com/api/v1/brands/9f2b7c41-58a0-4c3e-9d61-2f0c8b7d4a15 \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "name": "Quenzy Naturals" }'

const response = await fetch(
  "https://makelocalads.com/api/v1/brands/9f2b7c41-58a0-4c3e-9d61-2f0c8b7d4a15",
  {
    method: "PATCH",
    headers: {
      Authorization: `Bearer ${process.env.LOCALADS_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ name: "Quenzy Naturals" }),
  },
);

const brand = await response.json();

{
  "id": "9f2b7c41-58a0-4c3e-9d61-2f0c8b7d4a15",
  "name": "Quenzy Naturals",
  "slug": "quenzy-naturals",
  "website_url": "https://thequenzy.com",
  "created_at": "2026-08-12T10:00:00.000Z",
  "updated_at": "2026-11-04T09:30:00.000Z"
}

A request with no fields, or with a field the brand does not have, returns 400 invalid_request.

Delete a brand

Deleting a brand also deletes every product in it and stops any work in progress for them. It cannot be undone through the API.

curl --request DELETE \
  --url https://makelocalads.com/api/v1/brands/9f2b7c41-58a0-4c3e-9d61-2f0c8b7d4a15 \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

A successful delete returns 204 No Content. Afterwards the brand and its products return 404 brand_not_found and 404 product_not_found. You do not need to send brand_id when retrieving a resource by its ID. Photoshoot creation also omits it: LocalAds derives the brand from the selected product, and requires a template to belong to that same brand.

Get started

Set up

Ad campaigns

Listing images

Photoshoots

ChatGPT ads

Videos

Core concepts

Help

Open in LocalAds

List brands

Sort and filter

Create a brand

Input fields

One brand per website

Update a brand

Delete a brand

Open in LocalAds

​List brands

​Sort and filter

​Create a brand

​Input fields

​One brand per website

​Update a brand

​Delete a brand

List brands

Sort and filter

Create a brand

Input fields

One brand per website

Update a brand

Delete a brand