Methods that let you view the Audience Manager common taxonomy. This optional classification scheme organizes traits into industry standard categories.
You cannot create new taxonomic categories or classify traits with these methods. To classify a trait, specify the appropriate categoryId
with a trait create or update method.
A GET
method that returns details about the specified taxonomic category.
GET https://api.demdex.com/v1/taxonomies/0/
<categoryId>
A successful response returns 200 OK
and the category for the specified ID. An unsuccessful request returns 404 No Content
if the ID does not exist.
{
"crUID": 158,
"name": "Arts & Entertainment",
"upUID": 158,
"description": "Arts & Entertainment",
"categoryID": 1,
"parentCategoryID": 0
}
A GET
method that returns a list of the top-level categories in an array.
GET https://api.demdex.com/v1/taxonomies/0/
Truncated for brevity.
[
{
"crUID": 158,
"name": "Arts & Entertainment",
"upUID": 158,
"description": "Arts & Entertainment",
"categoryID": 1,
"parentCategoryID": 0
},
{
"crUID": 158,
"name": "Automotive",
"upUID": 158,
"description": "Automotive",
"categoryID": 2,
"parentCategoryID": 0
},
{
"crUID": 158,
"name": "Business",
"upUID": 158,
"description": "Business",
"categoryID": 3,
"parentCategoryID": 0
}
]
A GET
method that returns sub-categories for the specified parent category in an array.
GET https://api.demdex.com/v1/taxonomies/0/
<categoryId>
/childCategories/
A successful response returns 200 OK
and the category for the specified ID. An unsuccessful request returns 404 No Content
if the ID does not exist. Truncated for brevity.
[
{
"crUID": 158,
"name": "Books & Literature",
"upUID": 158,
"description": "Books & Literature",
"categoryID": 25,
"parentCategoryID": 1
},
{
"crUID": 158,
"name": "Celebrity Fan/Gossip",
"upUID": 158,
"description": "Celebrity Fan/Gossip",
"categoryID": 49,
"parentCategoryID": 1
},
{
"crUID": 158,
"name": "Fine Art",
"upUID": 158,
"description": "Fine Art",
"categoryID": 72,
"parentCategoryID": 1
}
]