Curated Categories
curated-categories

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.x.com/12/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.x.com/12/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.x.com/12/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.x.com/12/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
  }
}