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 https://makelocalads.com/api/v1/brands and POST https://makelocalads.com/api/v1/brands Permissions: list with products:read, create with products:create

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"
    }
  ]
}

Use the returned id as brand_id when creating a product, or when listing products and templates.

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

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

UGC videos

Core concepts

Help

Open in LocalAds

List brands

Create a brand

Input fields

One brand per website

Open in LocalAds

​List brands

​Create a brand

​Input fields

​One brand per website

List brands

Create a brand

Input fields

One brand per website