Curated Categories

GET accounts/:account_id/curated_categories

Retrieve a list of available Curated Categories for the given country_codes

Each curated_category is only available in specific countries specified by the country_codes in the response.

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

Resource URL

https://ads-api.twitter.com/9/accounts/:account_id/curated_categories

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource's path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

country_codes
required

Scope the response to just the desired countries by specifying a comma-separated list of two letter ISO country codes. Up to 200 IDs may be provided.

Type: string

Example: US

cursor
optional

Specifies a cursor to get the next page of results. See Pagination for more information.

Type: string

Example: 8x7v00oow

Example Request

GET https://ads-api.twitter.com/9/accounts/18ce54d4x5t/curated_categories?country_codes=US

Example Response

{
  "request": {
    "params": {
      "country_codes": [
        "US"
      ],
      "account_id": "18ce54d4x5t"
    }
  },
  "next_cursor": null,
  "data": [
    {
      "name": "Basketball",
      "description": "Run next to the best of everyday basketball content including college teams, professional teams, and the top sports media handles sharing on and off-season basketball video.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "20265254",
        "378174762",
        "900368808",
        "18939563",
        "18371803",
        "18360370",
        "770658432928079872",
        "11026952",
        "37085464",
        "16212685",
        "57422635",
        "281669945",
        "7117962",
        "23065057",
        "41688179",
        "29779226",
        "900280416",
        "364460082",
        "902030382",
        "19409270",
        "19077044",
        "18139461",
        "14992591",
        "66753565",
        "667563",
        "16727749",
        "40941404",
        "18481113",
        "791598918",
        "16201775",
        "15900167",
        "45891626",
        "191894553",
        "2181233851",
        "34352904",
        "171483987",
        "454122399",
        "57415242",
        "19263978",
        "902089998",
        "423540866",
        "2715223320",
        "22185437",
        "17292143",
        "55590247",
        "66757066",
        "22642626",
        "41604618",
        "87275465",
        "22643259",
        "32414973",
        "73406718",
        "20346956",
        "413422891",
        "45412765",
        "19537303",
        "459511725",
        "30954864",
        "21308488",
        "18552281",
        "19924520",
        "24903350",
        "851142163",
        "26270913",
        "20444254",
        "26074296",
        "6395222",
        "15537451",
        "28672101",
        "38053254",
        "24925573",
        "19564719",
        "18164425",
        "22815383",
        "20196159"
      ],
      "id": "929wbl6ymlfk",
      "created_at": "2019-11-08T21:12:47Z",
      "updated_at": "2021-03-09T20:36:44Z",
      "videos_monetized_in_last_thirty_days": 2446
    },
    {
      "name": "Gaming Personalities",
      "description": "Run next to the best of everyday gaming content exclusively from a list of some of online gaming’s biggest and most loved digital creators.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "90779436",
        "268270621",
        "567167802",
        "246596682",
        "474919140",
        "284422688",
        "185909682",
        "4767225325",
        "2559865245",
        "186888760",
        "161418822",
        "141021153",
        "352881953",
        "1117931702",
        "146556805",
        "357294577",
        "234526497",
        "266687361",
        "214201922",
        "9451052",
        "2163885564",
        "2231422037",
        "116952434",
        "399909209",
        "15993650",
        "974356091193741312",
        "210839744",
        "2313002094",
        "159916388",
        "3258981481",
        "231992478",
        "182236262",
        "386884916",
        "22705686",
        "4140881832",
        "995979576",
        "2244953047",
        "311775629",
        "98821255",
        "2733210014",
        "2741078150"
      ],
      "id": "94ngssfrr01x",
      "created_at": "2019-12-02T20:45:12Z",
      "updated_at": "2021-03-09T20:18:13Z",
      "videos_monetized_in_last_thirty_days": 448
    },
    {
      "name": "Baseball",
      "description": "Run next to the best of everyday baseball content including college teams, professional teams, and the top sports media handles sharing major baseball coverage.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "22016177",
        "22798877",
        "52803520",
        "20710218",
        "423532170",
        "28603812",
        "41144996",
        "22819823",
        "39389304",
        "252273678",
        "123307490",
        "2319354187",
        "41488578",
        "37947138",
        "302066953",
        "159143990",
        "35006336",
        "53178109",
        "40918816",
        "39682297",
        "39397148",
        "39419180",
        "53197137",
        "52863923",
        "21407926",
        "31164229",
        "19607400",
        "39392910",
        "241544156",
        "43024351",
        "37837907",
        "165764237",
        "69117905",
        "87673496",
        "23043294",
        "52824038",
        "52861612",
        "33137450",
        "30008146",
        "39367703",
        "21436663",
        "188575356",
        "40931019",
        "41468683",
        "40927173",
        "172742915"
      ],
      "id": "9lav5usxfmdc",
      "created_at": "2020-05-18T20:20:27Z",
      "updated_at": "2021-03-09T20:37:46Z",
      "videos_monetized_in_last_thirty_days": 190
    },
    {
      "name": "Esports Teams",
      "description": "Run next to the programming from the world’s best esports teams, covering both in-event coverage and other year-round complimentary programming.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "759527448757215232",
        "61933836",
        "477213534",
        "907193396049182720",
        "895382891408089089",
        "862708050116976640",
        "115038550",
        "3182089458",
        "4131266472",
        "1145702070961496065",
        "2262070855",
        "920664872786059264",
        "1035653581683220481",
        "14229141",
        "1101275970995027968",
        "20734751",
        "1452520626",
        "720303639277928448",
        "2853641871",
        "912696400571486208",
        "874362688939413504",
        "286505380",
        "892808605170245632",
        "875087838613733376",
        "238431491",
        "867053221940011014",
        "964529942",
        "1172506293174710272",
        "535756639",
        "2255226817",
        "1100825469853696000",
        "1122713320086220803",
        "1124064709295128581",
        "899858978418642944",
        "864977592532688896",
        "864476897106898944",
        "862770685445361665",
        "257268592"
      ],
      "id": "9ys3jz3ktreo",
      "created_at": "2020-10-01T20:02:35Z",
      "updated_at": "2021-03-09T20:36:20Z",
      "videos_monetized_in_last_thirty_days": 169
    },
    {
      "name": "Football ",
      "description": "Run next to the best of everyday football content including college teams, professional teams, and the top sports media handles sharing on and off-season football video.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "21790466",
        "53103297",
        "23642374",
        "817416193854283776",
        "43403778",
        "24179879",
        "26813914",
        "36375662",
        "33587536",
        "180884045",
        "16332223",
        "27902825",
        "180503626",
        "44468807",
        "18336787",
        "818431566",
        "22146282",
        "31126587",
        "40358743",
        "35865630",
        "16347506",
        "72665816",
        "33583496",
        "389038362",
        "36155311",
        "227342532",
        "2151130166",
        "26791995",
        "44666348",
        "24109979",
        "31504542",
        "713143",
        "423536031",
        "25545388",
        "59471027",
        "706923475",
        "19383279",
        "8824902",
        "1655877529",
        "18734310",
        "240734425",
        "17076218",
        "47964412",
        "2802184770",
        "19426729",
        "56443153",
        "23508439",
        "25084916",
        "764347046",
        "19853312",
        "348590880"
      ],
      "id": "8tujg1lvi8sn",
      "created_at": "2019-08-15T20:48:51Z",
      "updated_at": "2021-03-09T20:34:13Z",
      "videos_monetized_in_last_thirty_days": 254
    },
    {
      "name": "Men’s Culture + Lifestyle",
      "description": "Run next to content from a set of handles curated based on their follower profiles to help you reach a majority male audience, including some of the top handles sharing technology, news, and lifestyle content.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "17764377",
        "61933836",
        "28370738",
        "3224616765",
        "22819823",
        "18927441",
        "734826612684783616",
        "14372486",
        "7157132",
        "15764136",
        "590316679",
        "7302282",
        "895014043932540928",
        "7517222",
        "3489420013",
        "14063426",
        "72665816",
        "214201922",
        "14980903",
        "22199141",
        "21272440",
        "25319414",
        "119593082",
        "4760694445",
        "765905855195803648",
        "238431491",
        "22178780",
        "241544156",
        "25093616",
        "16877611",
        "22146985",
        "368703433",
        "14342661",
        "415605847",
        "2181233851",
        "890891",
        "15764001",
        "614754689",
        "18479513",
        "23508439",
        "348590880"
      ],
      "id": "8tujj1ep7t34",
      "created_at": "2019-08-15T20:49:47Z",
      "updated_at": "2021-03-09T20:39:00Z",
      "videos_monetized_in_last_thirty_days": 1330
    },
    {
      "name": "Women’s Culture + Lifestyle",
      "description": "Run next to content from a set of handles curated based on their follower profiles to help you reach a majority female audience, including some of the top handles sharing pop culture, news, and lifestyle content.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "23482952",
        "20177423",
        "19074134",
        "15566901",
        "32469566",
        "19784831",
        "16145224",
        "16932962",
        "14934818",
        "29730065",
        "24190981",
        "30278532",
        "15846407",
        "24994219",
        "23993734",
        "40965341",
        "16312576",
        "75094638",
        "549673665",
        "18806753",
        "75306892",
        "1482663290",
        "31181674",
        "971407531972186112",
        "4020532937",
        "25087685",
        "22515362",
        "80943051",
        "19247844",
        "15279429",
        "16824090",
        "20710809",
        "979831113655996416",
        "32432308",
        "19472585",
        "25589776",
        "739963476370673665",
        "20188834",
        "926269727663673349"
      ],
      "id": "8tujl1p3yn0g",
      "created_at": "2019-08-15T20:50:24Z",
      "updated_at": "2021-03-09T20:17:53Z",
      "videos_monetized_in_last_thirty_days": 1365
    },
    {
      "name": "Light-Hearted",
      "description": "Run next to a list of handles curated for the volume of positive, feel-good content and conversation they’ve consistently generated on Twitter.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "20177423",
        "22449367",
        "9695312",
        "19074134",
        "4805771380",
        "32469566",
        "1212860112047460352",
        "16402507",
        "16932962",
        "14934818",
        "17446621",
        "29730065",
        "15846407",
        "1604444052",
        "180066380",
        "16312576",
        "549673665",
        "18806753",
        "16211434",
        "545336345",
        "971407531972186112",
        "4020532937",
        "833612154",
        "22515362",
        "20710809",
        "32432308",
        "774311630",
        "3073349892",
        "926269727663673349"
      ],
      "id": "9fg8gmz96qdg",
      "created_at": "2020-03-20T19:37:44Z",
      "updated_at": "2021-03-09T19:57:40Z",
      "videos_monetized_in_last_thirty_days": 1395
    },
    {
      "name": "Soccer",
      "description": "Run next to the best of everyday soccer content including college teams, professional teams, and the top sports media handles sharing major soccer coverage.",
      "country_codes": [
        "US"
      ],
      "publisher_user_ids": [
        "21677316",
        "20636347",
        "4704552148",
        "14573900",
        "22556296",
        "1415791555",
        "107146095",
        "17288520",
        "213474069",
        "17493398",
        "44990136",
        "452155423",
        "17744542",
        "16303450",
        "2841146601",
        "2413176055",
        "29739264",
        "38580532",
        "953476292913106945",
        "27092557",
        "86356439",
        "34613288",
        "3170659367",
        "119593082",
        "73412535",
        "627586654",
        "15891449",
        "23011345",
        "96951800",
        "15997022",
        "16960789",
        "21919642",
        "102965285",
        "17224076",
        "36432200",
        "1410055968"
      ],
      "id": "9ddrgesiap6o",
      "created_at": "2020-02-28T22:43:26Z",
      "updated_at": "2021-01-26T17:54:55Z",
      "videos_monetized_in_last_thirty_days": 421
    }
  ],
  "total_count": 9
}

GET accounts/:account_id/curated_categories/:curated_category_id

Retrieve details for a specific curated_category_id

Each curated_category is only available in specific countries specified by the country_codes in the response.

Resource URL

https://ads-api.twitter.com/9/accounts/:account_id/curated_categories/:curated_category_id

Parameters

Name Description
account_id
required

The identifier for the leveraged account. Appears within the resource's path and is generally a required parameter for all Advertiser API requests excluding GET accounts. The specified account must be associated with the authenticated user.

Type: string

Example: 18ce54d4x5t

curated_category_id
required

A reference to the Curated Category you are operating with in the request.

Type: string

Example: 9ddrgesiap6o

Example Request

GET https://ads-api.twitter.com/9/accounts/18ce54d4x5t/curated_categories/9ddrgesiap6o

Example Response

{
  "request": {
    "params": {
      "id": "9ddrgesiap6o",
      "account_id": "18ce54d4x5t"
    }
  },
  "data": {
    "name": "Soccer",
    "description": "Run next to the best of everyday soccer content including college teams, professional teams, and the top sports media handles sharing major soccer coverage.",
    "country_codes": [],
    "publisher_user_ids": [
      "21677316",
      "20636347",
      "4704552148",
      "14573900",
      "22556296",
      "1415791555",
      "107146095",
      "17288520",
      "213474069",
      "17493398",
      "44990136",
      "452155423",
      "17744542",
      "16303450",
      "2841146601",
      "2413176055",
      "29739264",
      "38580532",
      "953476292913106945",
      "27092557",
      "86356439",
      "34613288",
      "3170659367",
      "119593082",
      "73412535",
      "627586654",
      "15891449",
      "23011345",
      "96951800",
      "15997022",
      "16960789",
      "21919642",
      "102965285",
      "17224076",
      "36432200",
      "1410055968"
    ],
    "id": "9ddrgesiap6o",
    "created_at": "2020-02-28T22:43:26Z",
    "updated_at": "2021-01-26T17:54:55Z",
    "videos_monetized_in_last_thirty_days": 421
  }
}
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.