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:
|
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: |
cursor optional |
Specifies a cursor to get the next page of results. See Pagination for more information. Type: string Example:
|
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:
|
curated_category_id required |
A reference to the Curated Category you are operating with in the request. Type: string Example:
|
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
}
}