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.twitter.com/10/content_categories

Parameters

No request parameters

Example Request

GET https://ads-api.twitter.com/10/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
}
Was this document helpful?
Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?
Thank you for the feedback. Your comments will help us improve our documents in the future.