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 - e.g. in order to implement Marketplace Audience Targeting.
Example:
GET /backstage/api/1.0/demo-account/dictionary/audience_segments/
{
"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.)
Uses thedictionary
endpoint - and returns a more complex object than theresources
endpoint.
The payload for this endpoint is typically large.
Invalid account_idIf you pass an invalid
account_id
, the endpoint returns a successful response with an empty collection in theresults
property (unlike other endpoints that return 400 Bad Request).
{
"results": [],
"metadata": {
"total": null,
"count": null,
"static_fields": [],
"static_total_fields": []
}
}