curl --request GET \
--url 'https://api.growthchannel.io/audiences/filters' \
--header 'X-Api-Key: YOUR_API_KEY'
Public endpoints
Audience Filters
Get the available filter values for Audience Search: geos, providers, size and CPM ranges.
GET
/
audiences
/
filters
curl --request GET \
--url 'https://api.growthchannel.io/audiences/filters' \
--header 'X-Api-Key: YOUR_API_KEY'
This endpoint is protected and requires an agency API key for access.
curl --request GET \
--url 'https://api.growthchannel.io/audiences/filters' \
--header 'X-Api-Key: YOUR_API_KEY'
Method
GETEndpoint
/audiences/filtersgeo, provider, min_size, max_size, min_cpm and max_cpm parameters of Audience Search.
Headers
string
required
The agency’s API key for authorization. Contact an admin to get one.
Parameters
This endpoint has no parameters.Responses
- 200 OK
- 401 Unauthorized
- 500 Internal Server Error
{
"data": {
"geos": ["CA", "GB", "US"],
"providers": ["Provider A", "Provider B"],
"min_size": 1000,
"max_size": 250000000,
"min_cpm": 0.25,
"max_cpm": 6.5
}
}
object
Available filter values across the whole audience catalog.
Show object
Show object
array
All available geos, sorted alphabetically. Use one as the
geo parameter.array
All available data providers, sorted alphabetically. Use one as the
provider parameter.integer | null
The smallest and largest audience size in the catalog.
number | null
The lowest and highest audience CPM in the catalog.
Returned if the
X-Api-Key header is missing or invalid.{
"error": {
"code": "UNAUTHORIZED",
"message": "X-Api-Key header required",
"details": {
"field": "X-Api-Key",
"issue": "missing"
},
"request_id": "..."
}
}
Returned if there is an unexpected error on the server while fetching filters.
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Failed to fetch audience filters",
"details": {},
"request_id": "..."
}
}