---
title: "List custom, lookalike, and retargeting audiences"
method: GET
path: "/audiences"
---

# List custom, lookalike, and retargeting audiences

`GET /audiences`

## Request

- Base URL: `https://lazyads.ai/api/v1`
- URL: `https://lazyads.ai/api/v1/audiences`
- Auth: HTTP bearer

Audiences on the connected ad account with approximate sizes, plus the audience plan Lazy Ads derives (exclusion ids, warm retargeting ids, lookalike seed, recommended audiences to create).

## Query parameters

- `platform` 'meta' | 'google' | 'tiktok' | 'linkedin' | 'reddit' | 'apple' | 'bing' | 'chatgpt' | 'snapchat', required

## Response `200`

Audiences and plan

- object
  - `data` object
    - `platform` string
    - `capabilities` object
    - `audiences` Audience[]
      - `id` string
      - `name` string
      - `kind` 'website_visitors' | 'website_event' | 'purchasers' | 'leads' | 'customer_list' | 'engagement' | 'app' | 'lookalike' | 'saved' | 'other'
      - `approximateSize` integer, nullable
      - `retentionDays` integer, nullable
      - `eventName` string, nullable
      - `seedAudienceId` string, nullable
      - `lookalikeRatio` number, nullable
      - `status` string, nullable
      - `createdByLazyAds` boolean
    - `plan` object
    - `warnings` string[]

---

[API](https://skmtc.dev/lazyads/apis/lazyads-api.md) · [All operations](https://skmtc.dev/lazyads/apis/lazyads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lazyads/apis/lazyads-api/revisions/7d5de42538e9?raw)