Digital Platform API - Content Category service

  • Article

Xandr provides a set of "universal" categories, which are commonly used categories that members can apply to their sites (placement groups) and placements for later targeting or informational purposes. You can also create your own custom categories by using this service.

You apply content categories to sites and placements through the Site Service and Placement Service using the content category ID, retrieved from this service. Content categories can then be used for site and placement targeting for direct campaigns through the Profile Service.

REST API

HTTP Method Endpoint Description
GET https://api.appnexus.com/content-category?type=standard View all standard custom content categories belonging to your member.
GET https://api.appnexus.com/content-category?category_type=universal&id=CONTENT_CATEGORY_ID View a specific custom content category.
GET https://api.appnexus.com/content-category?id=1,2,3 View multiple content categories by ID using a comma-separated list.
POST https://api.appnexus.com/content-category Add a custom content category.
PUT https://api.appnexus.com/content-category?id=CONTENT_CATEGORY_ID Modify a custom content category.
DELETE https://api.appnexus.com/content-category?id=CONTENT_CATEGORY_ID Delete a custom content category.

Tip: You cannot add, modify, or delete universal content categories (where is_system is set to true). Universal content categories are managed by Xandr.

JSON fields

Field Type (Length) Description
code string Used only for deals.
description string (255) The description of the content category
id int The ID of the category.
Required On: PUT
Default: Auto-generated number.
is_system boolean Read Only. If true, this is a "universal" content category created by Xandr. You can apply universal content categories to your sites and placements, but you cannot edit them.
last_modified timestamp Read Only. The date and time that this content category was last modified.
member_id int Read Only. Your member ID.
name string (100) The name of the category.
Required On: POST
parent_category object If the category is the child of a parent category, the ID and name of the parent is listed in a format.
type enum The type of content category. Possible values are "standard", "deal", or "deal_priority".

parent_category format

"parent_category": {
"id": 10,
"name": "Games"
}

Examples

View all custom content categories belonging to your member

$ curl -b cookies 'https://api.appnexus.com/content-category'
{
   "response":{
      "status":"OK",
      "content-categories":[
         {
            "id":9999,
            "name":"Animals",
            "description":null,
            "is_system":false,
            "type":"standard",
            "code": null,
            "last_modified":"2010-05-12 22:46:42"
         },
         {
            "id":8888,
            "name":"Arts & Humanities",
            "description":null,
            "is_system":false,
            "type":"standard",
            "code": null,
            "last_modified":"2010-05-12 22:46:42"
         },
         ...
         {
            "id":7777,
            "name":"Travel",
            "description":null,
            "is_system":false,
            "type":"standard",
            "code": null,
            "last_modified":"2010-05-12 22:46:42"
         }
      ]
   }
}

View all universal content categories

$ curl -b cookies -c cookies 'https://api.appnexus.com/content-category?is_system=true'
{
    "response": {
        "status": "OK",
        "content-categories": [
            {
              "id": 1,
              "name": "Music",
              "description": null,
              "is_system": true,
              "parent_category": null,
              "type": "standard",
              "code": null,
              "last_modified": "2010-03-04 18:18:52"
            },
            
            {
              "id": 2,
              "name": "Pets & Animals",
              "description": null,
              "is_system": true,
              "parent_category": null,
              "type": "standard",
              "code": null,
              "last_modified": "2010-10-24 02:43:16"
            },
            {
              "id": 3,
              "name": "Fun & Trivia",
              "description": null,
              "is_system": true,
              "parent_category": {
                "id": "10",
                "name": "Arts & Entertainment"
              },
              "type": "standard",
              "code": null,
              "last_modified": "2010-10-24 02:43:16"
            },
            {
              "id": 4,
              "name": "Autos & Vehicles",
              "description": null,
              "is_system": true,
              "parent_category": null,
              "type": "standard",
              "code": null,
              "last_modified": "2010-10-24 02:43:16"
            },
            ...
        ],
        "count": 34,
        "start_element": null,
        "num_elements": null
    }
}

View a specific custom content category

$ curl -b cookies -c cookies 'https://api.appnexus.com/content-category?category_type=universal&id=11111'
{
    "response": {
        "status": "OK",
        "content-category": {
            "id": 11111,
            "name": "A fine and private placement",
            "description": null,
            "is_system": false,
            "parent_category": null,
            "type": "standard",
            "code": null,
            "last_modified": "2012-08-29 15:42:01"
        },
        "count": 1,
        "start_element": 0,
        "num_elements": 100
    }
}

View a specific universal content category

$ curl -b cookies -c cookies 'https://api.appnexus.com/content-category?is_system=true&id=2222'
{
    "response": {
        "status": "OK",
        "content-category": {
            "id": 2222,
            "name": "Small Business",
            "description": null,
            "is_system": true,
            "type": "standard",
            "code": null,
            "parent_category": {
                "id": "8"
            },
            "last_modified": "2010-10-24 02:43:16"
        },
        "count": 1,
        "start_element": 0,
        "num_elements": 100
    }
}