Parameters
page
number
Description
Page number for pagination. Default is 1.
per_page
number
Description
Number of records per page (1-100). Default is 30.
audience_type
string
Description
Filter by audience type (`user` or `account`).
status
string
Description
Filter by status: `draft`, `active`, or `inactive`.
sort
string
Description
Sort order: `newest_first`, `oldest_first`, `name_asc`, or `name_desc`.
GET/v1/audiences
bash
curl https://api.tradly.app/v1/audiences \
-H "Authorization: Bearer YOUR_PUBLISHABLE_OR_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{}'RESPONSE
json
{
"status": true,
"data": {
"total_records": 2,
"page": 1,
"audiences": [
{
"id": 1,
"name": "High-Value Buyers",
"description": "Buyers with gold tier or above",
"audience_type": "user",
"status": "active",
"filters": [
{
"dimension": "user_type",
"operator": "includes",
"value": "buyer"
}
],
"estimated_count": 142,
"last_calculated_at": 1723068000,
"created_by": 10,
"updated_by": 10,
"created_at": 1723068000,
"updated_at": 1723068000
},
{
"id": 2,
"name": "Verified Merchant Accounts",
"description": "Accounts with active merchant status",
"audience_type": "account",
"status": "active",
"filters": [
{
"dimension": "metadata",
"path": "verified",
"operator": "equals",
"value": true
}
],
"estimated_count": 35,
"last_calculated_at": 1723068000,
"created_by": 10,
"updated_by": 10,
"created_at": 1723068000,
"updated_at": 1723068000
}
]
}
}