[BETA] Get Audiences
Auction examples
- Running auctions
- Sponsored listings
- Sponsored banners
- Sponsored brands
Asset examples
Webhook examples
Events
Audience API
Billing API
Campaign API
- GETGet Campaigns
- POSTCreate Campaign
- GETGet Campaign By Id
- DELDelete Campaign By Id
- PATCHUpdate Campaign By Id
- GETGet Campaign Bids
- POSTCreate Campaign Bids
- DELDelete Campaign Bid By Id
- PATCHUpdate Campaign Bid By Id
- POST[BETA] Get estimated clicks of a future campaign for a given vendor
- GETGet Products In Campaign
- GETGet Sponsored Products
Catalog API
Invitation API
Modal API
Reporting API
Assets API
Audience API
Billing API
Campaign API
- GETGet Campaigns
- POSTCreate Campaign
- GETGet Campaign By Id
- DELDelete Campaign By Id
- PATCHUpdate Campaign By Id
- GETGet Campaign Bids
- POSTCreate Campaign Bids
- DELDelete Campaign Bid By Id
- PATCHUpdate Campaign Bid By Id
- POST[BETA] Get estimated clicks of a future campaign for a given vendor
- GETGet Products In Campaign
- GETGet Sponsored Products
Catalog API
Invitation API
Modal API
Reporting API
Toppie API
[BETA] Get Audiences
Get audiences.
GET
/
public
/
v1
/
audiences
curl --request GET \
--url https://api.topsort.com/public/v1/audiences
{
"audiences": [
{
"audienceKey": "age",
"audienceValues": [
"18-24",
"25-34"
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"hasMore": true,
"nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}
Query Parameters
Pagination cursor as provided in an earlier response. If provided will fetch the next page of results.
The maximum number of audiences to retrieve.
Required range:
0 < x < 100
Response
201
application/json
Successful Response
Paginated list of audiences.
List of audiences.
Unique identifier for categorizing audiences.
Required string length:
2 - 25
List of specific values under this category.
Datetime of when the audience was created.
Datetime of the audience's last update.
Flag that indicates whether more results are available. true
indicates there is a next page of results. false
indicates this response contains the last page of results.
Pagination cursor. Provide this value as a next_page
query parameter in a new request to retrieve the next page of results.
Minimum length:
1
curl --request GET \
--url https://api.topsort.com/public/v1/audiences
{
"audiences": [
{
"audienceKey": "age",
"audienceValues": [
"18-24",
"25-34"
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"hasMore": true,
"nextPage": "SSBzb2xlbW5seSBzd2VhciB0aGF0IEkgYW0gdXAgdG8gbm8gZ29vZAo="
}