Content Categories

GET content_categories¶

Request the valid content categories to be set as targeting_criteria for a line item.

Each content_category maps to one or more IAB Categories. This can be done by setting the targeting_type to IAB_CATEGORY on the batch targeting_critera endpoint to include the set of corresponding iab_categories returned by the content_categories request. Failure to do so will result in a validation error.

Publisher details for each of these content categories can be retrieved using the GET publishers endpoint.

Additional details can be found in the Video Views Pre-roll Objective Guide.

Resource URL¶

https://ads-api.x.com/12/content_categories

Parameters¶

No request parameters

Example Request¶

GET https://ads-api.x.com/12/content_categories

Example Response¶

{
  "request": {
    "params": {}
  },
  "next_cursor": null,
  "data": [
    {
      "name": "Automotive (Cars, Trucks, Racing)",
      "id": "ru",
      "iab_categories": [
        "IAB2"
      ],
      "publishers_in_last_thirty_days": 12,
      "videos_monetized_in_last_thirty_days": 316
    },
    {
      "name": "Comedy",
      "id": "sk",
      "iab_categories": [
        "IAB1-4"
      ],
      "publishers_in_last_thirty_days": 19,
      "videos_monetized_in_last_thirty_days": 174
    },
    {
      "name": "Digital Creators",
      "id": "sl",
      "iab_categories": [
        "IAB25-1"
      ],
      "publishers_in_last_thirty_days": 110,
      "videos_monetized_in_last_thirty_days": 1257
    },
    {
      "name": "Entertainment & Pop Culture",
      "id": "sm",
      "iab_categories": [
        "IAB1-1",
        "IAB1-2",
        "IAB1-3",
        "IAB1-5"
      ],
      "publishers_in_last_thirty_days": 120,
      "videos_monetized_in_last_thirty_days": 3482
    },
    {
      "name": "Financial & Business News",
      "id": "sn",
      "iab_categories": [
        "IAB3",
        "IAB13",
        "IAB21"
      ],
      "publishers_in_last_thirty_days": 29,
      "videos_monetized_in_last_thirty_days": 1461
    },
    {
      "name": "Food & Drink",
      "id": "so",
      "iab_categories": [
        "IAB8-8",
        "IAB8-12",
        "IAB8-17",
        "IAB8-2",
        "IAB8-3",
        "IAB8-7",
        "IAB8-11",
        "IAB8-4",
        "IAB8-14",
        "IAB8-10",
        "IAB8-15",
        "IAB8-13",
        "IAB8-9",
        "IAB8-16",
        "IAB8-6",
        "IAB8-1"
      ],
      "publishers_in_last_thirty_days": 24,
      "videos_monetized_in_last_thirty_days": 516
    },
    {
      "name": "Lifestyle (Fashion, Travel, Wellness)",
      "id": "sp",
      "iab_categories": [
        "IAB16",
        "IAB9-21",
        "IAB9-4",
        "IAB9-25",
        "IAB9-8",
        "IAB4",
        "IAB9-3",
        "IAB9-15",
        "IAB7",
        "IAB6",
        "IAB9-11",
        "IAB9-16",
        "IAB9-7",
        "IAB9-20",
        "IAB9-24",
        "IAB9-17",
        "IAB9-12",
        "IAB9-31",
        "IAB9-27",
        "IAB10",
        "IAB9-10",
        "IAB9-23",
        "IAB9-6",
        "IAB9-18",
        "IAB9-13",
        "IAB9-1",
        "IAB9-28",
        "IAB20",
        "IAB9-5",
        "IAB9-26",
        "IAB22",
        "IAB23",
        "IAB9-9",
        "IAB9-22",
        "IAB18",
        "IAB9-2",
        "IAB9-19",
        "IAB9-14",
        "IAB9-29"
      ],
      "publishers_in_last_thirty_days": 67,
      "videos_monetized_in_last_thirty_days": 2412
    },
    {
      "name": "Music",
      "id": "sq",
      "iab_categories": [
        "IAB1-6"
      ],
      "publishers_in_last_thirty_days": 31,
      "videos_monetized_in_last_thirty_days": 518
    },
    {
      "name": "News & Current Events",
      "id": "sr",
      "iab_categories": [
        "IAB12",
        "IAB14"
      ],
      "publishers_in_last_thirty_days": 125,
      "videos_monetized_in_last_thirty_days": 5507
    },
    {
      "name": "Politics",
      "id": "s4",
      "iab_categories": [
        "IAB11"
      ],
      "publishers_in_last_thirty_days": 19,
      "videos_monetized_in_last_thirty_days": 1402
    },
    {
      "name": "Science & Education",
      "id": "ss",
      "iab_categories": [
        "IAB5",
        "IAB15"
      ],
      "publishers_in_last_thirty_days": 7,
      "videos_monetized_in_last_thirty_days": 132
    },
    {
      "name": "Sports",
      "id": "se",
      "iab_categories": [
        "IAB17"
      ],
      "publishers_in_last_thirty_days": 403,
      "videos_monetized_in_last_thirty_days": 18281
    },
    {
      "name": "Technology",
      "id": "sg",
      "iab_categories": [
        "IAB19"
      ],
      "publishers_in_last_thirty_days": 13,
      "videos_monetized_in_last_thirty_days": 1089
    },
    {
      "name": "Television",
      "id": "sh",
      "iab_categories": [
        "IAB1-7"
      ],
      "publishers_in_last_thirty_days": 58,
      "videos_monetized_in_last_thirty_days": 1307
    },
    {
      "name": "Esports & Video Games",
      "id": "s0",
      "iab_categories": [
        "IAB9-30"
      ],
      "publishers_in_last_thirty_days": 109,
      "videos_monetized_in_last_thirty_days": 1844
    }
  ],
  "total_count": 15
}