get https://backstage.taboola.com/backstage/api/1.0//dictionary/audience_segments/
Get a list of available Marketplace Audiences (aka Third Party Audience Segments) for the specified account and country - e.g. in order to implement Marketplace Audience Targeting.
Example:
GET /backstage/api/1.0/demo-account/dictionary/audience_segments/US
{
"results": [
{
"taboola_audience_id": 2,
"data_partner": "Acxiom",
"data_partner_audience_id": "300441499",
"data_partner_group": "Acxiom",
"audience_name": "ACXM Automotive > Likely In Market Timing > New Luxury Vehicle",
"allowed_countries": [
"AR",
"MX",
"US",
"CA"
],
"taxonomy_categories": [
"Intent",
"Autos & Vehicles"
],
"audience_size": 0
},
{
"taboola_audience_id": 3,
"data_partner": "Acxiom",
"data_partner_audience_id": "300448599",
"data_partner_group": "Acxiom",
"audience_name": "ACXM Automotive > Likely In Market Timing > New Vehicle",
"allowed_countries": [
"AR",
"MX",
"CA",
"US"
],
"taxonomy_categories": [
"Intent",
"Autos & Vehicles"
],
"audience_size": 0
}
// Additional rows (objects) omitted
]
}
As of 2020-11-18, audience size reflects the estimated number of users with visible activity in the Taboola network, over the past 30 days. (Previously, it reflected an average, daily amount.)
If you pass an
account_idorcountrythat does not exist, the endpoint will return a successful response with an empty collection.
{
"results": [],
"metadata": {
"total": null,
"count": null,
"static_fields": [],
"static_total_fields": []
}
}