> ## Documentation Index
> Fetch the complete documentation index at: https://docs.growthchannel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Audience Filters

> Get the available filter values for Audience Search: geos, providers, size and CPM ranges.

> [!NOTE]
>
> This endpoint is protected and requires an agency API key for access.

```bash Request theme={null}
  curl --request GET \
    --url 'https://api.growthchannel.io/audiences/filters' \
    --header 'X-Api-Key: YOUR_API_KEY'
```

> **Method**
>
> `GET`

> **Endpoint**
>
> `/audiences/filters`

Use these values for the `geo`, `provider`, `min_size`, `max_size`, `min_cpm` and `max_cpm` parameters of [Audience Search](https://docs.growthchannel.com/api-reference/audience-search).

## Headers

**X-Api-Key** `string` *required*

The agency's API key for authorization. Contact an admin to get one.

## Parameters

This endpoint has no parameters.

## Responses

**200 OK**

```json theme={null}
{
  "data": {
    "geos": ["CA", "GB", "US"],
    "providers": ["Provider A", "Provider B"],
    "min_size": 1000,
    "max_size": 250000000,
    "min_cpm": 0.25,
    "max_cpm": 6.5
  }
}
```

**data** `object`

Available filter values across the whole audience catalog.

**object**

**geos** `array`

All available geos, sorted alphabetically. Use one as the `geo` parameter.

**providers** `array`

All available data providers, sorted alphabetically. Use one as the `provider` parameter.

**min\_size, max\_size** `integer | null`

The smallest and largest audience size in the catalog.

**min\_cpm, max\_cpm** `number | null`

The lowest and highest audience CPM in the catalog.

**401 Unauthorized**

Returned if the `X-Api-Key` header is missing or invalid.

```json theme={null}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "X-Api-Key header required",
    "details": {
      "field": "X-Api-Key",
      "issue": "missing"
    },
    "request_id": "..."
  }
}
```

**500 Internal Server Error**

Returned if there is an unexpected error on the server while fetching filters.

```json theme={null}
{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Failed to fetch audience filters",
    "details": {},
    "request_id": "..."
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.