Audiences

An audience is a group of people a product is for. Campaigns and UGC videos are written for one, the same way the app works: first the audience, then the ads. The flow takes three calls:

Create a product. LocalAds reads it and generates its audiences automatically. They are saved as soon as they are written; there is nothing to approve.
List the product’s audiences and pick one.
Create a campaign or a UGC video with that audience’s id as audience_id.

Audiences are free. Listing them needs products:read; generating, adding, editing and archiving them need products:update (products:delete to archive).

1. Wait for the audiences

A new product generates its audiences once its details are read, usually within a minute or two. GET /products/{product_id} shows how far along it is:

{
  "id": "a1516a75-9be5-461a-93af-c1896a0a3127",
  "name": "First Flush Darjeeling Tea",
  "status": "ready",
  "audiences": { "count": 3, "generation_status": "ready" }
}

generation_status is generating while they are being written, then ready. If it reads failed, generate more.

2. List and pick one

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

{
  "generation_status": "ready",
  "data": [
    {
      "id": "2b12fc60-a380-49a2-99f9-33f4f15d386c",
      "name": "Anirban, The Heritage Purist",
      "demographic": "Age 35-60, senior professionals in Kolkata, Mumbai and Delhi",
      "motivation": "The finest single-estate spring harvest, never blended or stale",
      "created_at": "2026-09-30T01:36:55.984Z"
    },
    {
      "id": "af9852a2-152c-4cf1-8048-7612ddf111a9",
      "name": "Meera, The Conscious Ritualist",
      "demographic": "Age 25-40, urban professionals who value organic, sustainable living",
      "motivation": "A light, naturally sweet alternative to coffee for the afternoon break",
      "created_at": "2026-09-30T01:36:55.984Z"
    }
  ]
}

Every audience listed is saved and ready. Pick any one.

3. Make ads for it

Pass the audience’s id as audience_id:

curl --request POST \
  --url https://makelocalads.com/api/v1/campaigns \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
    "audience_id": "2b12fc60-a380-49a2-99f9-33f4f15d386c",
    "blueprint_id": "viral-pattern-interrupt",
    "creative_count": 5
  }'

audience_id is required when creating a guided campaign, video concepts or a UGC video, so an audience is never skipped by accident. To make something for everyone on purpose, send "audience_id": null. See Create a campaign and Create a video ad for the rest of each request.

Generate more audiences

Ask for a fresh set at any time. They are saved automatically, like the first ones:

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

This answers 202 Accepted. Poll GET /products/{product_id}/audiences until generation_status is ready.

Add an audience in your own words

curl --request POST \
  --url https://makelocalads.com/api/v1/products/a1516a75-9be5-461a-93af-c1896a0a3127/audiences \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "description": "Corporate buyers sending premium gifts to top clients." }'

LocalAds turns the description into a full audience and returns it with 201 Created.

Edit an audience

Describe what should change:

curl --request PATCH \
  --url https://makelocalads.com/api/v1/products/a1516a75-9be5-461a-93af-c1896a0a3127/audiences/2b12fc60-a380-49a2-99f9-33f4f15d386c \
  --header "Authorization: Bearer $LOCALADS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "description": "Focus on buyers who gift tea at Diwali." }'

Archive an audience

curl --request DELETE \
  --url https://makelocalads.com/api/v1/products/a1516a75-9be5-461a-93af-c1896a0a3127/audiences/2b12fc60-a380-49a2-99f9-33f4f15d386c \
  --header "Authorization: Bearer $LOCALADS_API_KEY"

This answers 204 No Content. The audience stops appearing in lists and can no longer be passed as audience_id. Campaigns and videos already made for it are not affected.

Start here

Build with LocalAds

Help

1. Wait for the audiences

2. List and pick one

3. Make ads for it

Generate more audiences

Add an audience in your own words

Edit an audience

Archive an audience

​1. Wait for the audiences

​2. List and pick one

​3. Make ads for it

​Generate more audiences

​Add an audience in your own words

​Edit an audience

​Archive an audience

1. Wait for the audiences

2. List and pick one

3. Make ads for it

Generate more audiences

Add an audience in your own words

Edit an audience

Archive an audience