curl --request GET \
--url 'https://api.growthchannel.io/audiences/search?search=Protein%20bar' \
--header 'X-Api-Key: YOUR_API_KEY'
curl --request GET \
--url 'https://api.growthchannel.io/audiences/search?search=Protein%20bar&limit=50&geo=US&min_size=10000&max_size=5000000' \
--header 'X-Api-Key: YOUR_API_KEY'
Public endpoints
Audience Search
Search the audience catalog by name and meaning, with optional geo, provider, size and CPM filters.
GET
/
audiences
/
search?search=
{search}
curl --request GET \
--url 'https://api.growthchannel.io/audiences/search?search=Protein%20bar' \
--header 'X-Api-Key: YOUR_API_KEY'
curl --request GET \
--url 'https://api.growthchannel.io/audiences/search?search=Protein%20bar&limit=50&geo=US&min_size=10000&max_size=5000000' \
--header 'X-Api-Key: YOUR_API_KEY'
Maximum 100 audiences per request
This endpoint is protected and requires an agency API key for access.
curl --request GET \
--url 'https://api.growthchannel.io/audiences/search?search=Protein%20bar' \
--header 'X-Api-Key: YOUR_API_KEY'
curl --request GET \
--url 'https://api.growthchannel.io/audiences/search?search=Protein%20bar&limit=50&geo=US&min_size=10000&max_size=5000000' \
--header 'X-Api-Key: YOUR_API_KEY'
Method
GETEndpoint
/audiences/searchRanking
Results are returned in three tiers:- Phrase matches: the audience name contains the search words in the same order, for example “Protein Bar Buyers” or “Protein-Bar Lovers”.
- Word matches: the audience name contains all search words in any order, for example “Bar Protein Fans”.
- Similar audiences: audiences close in meaning, for example “Energy Snacks”.
bars matches “Bar”, buyer matches “Buyers”. Within each tier the most relevant audiences come first. Each audience appears only once.
Headers
string
required
The agency’s API key for authorization. Contact an admin to get one.
Parameters
string
required
Text to search for, for example
Protein bar.integer
default:"20"
Maximum number of audiences to return, from
20 to 100. Values below 20 are treated as 20, values above 100 as 100.string
Return only audiences for this geo, for example
US. Exact match. See Audience Filters for available values.string
Return only audiences from this data provider. Exact match. See Audience Filters for available values.
integer
Minimum audience size. Applied only together with
max_size.integer
Maximum audience size. Applied only together with
min_size.number
Minimum CPM, for example
1.5. Applied only together with max_cpm.number
Maximum CPM. Applied only together with
min_cpm.Responses
- 200 OK
- 400 Bad Request
- 401 Unauthorized
- 500 Internal Server Error
{
"data": [
{
"audience_id": "101",
"name": "Protein Bar Buyers",
"taxonomy_path": "Food > Snacks > Protein Bars",
"description": "Shoppers who bought protein bars in the last 90 days.",
"geo": "US",
"size": 1250000,
"cpm": 1.5
},
{
"audience_id": "102",
"name": "Bar Protein Fans",
"taxonomy_path": "Health & Fitness > Nutrition",
"description": "Fitness enthusiasts interested in protein snacks.",
"geo": "US",
"size": 830000,
"cpm": 1.25
}
]
}
array
An array of audience objects in ranked order. Contains at most
limit items, or fewer when the filters leave fewer audiences.Returned if Returned if Returned if
search is missing.{
"error": {
"code": "VALIDATION_ERROR",
"message": "search parameter is required.",
"details": {},
"request_id": "..."
}
}
min_size, max_size, min_cpm or max_cpm is not a number.{
"error": {
"code": "VALIDATION_ERROR",
"message": "Size and CPM params must be numbers.",
"details": {},
"request_id": "..."
}
}
limit is not an integer.{
"error": {
"code": "VALIDATION_ERROR",
"message": "limit param must be a number.",
"details": {},
"request_id": "..."
}
}
Returned if the
X-Api-Key header is missing or invalid.{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid API key",
"details": {
"field": "X-Api-Key",
"issue": "invalid"
},
"request_id": "..."
}
}
Returned if there is an unexpected error on the server while searching audiences.
{
"error": {
"code": "INTERNAL_ERROR",
"message": "Failed to search audiences",
"details": {},
"request_id": "..."
}
}