GET
/
popularVideos
curl --request GET \
  --url https://api.poix.io/popularVideos \
  --header 'Authorization: Bearer <token>'
{
  "totalResults": 200,
  "resultsPerPage": 5,
  "nextPageToken": "CAUQAA",
  "data": [
    {
      "id": "snX5YyflrGw",
      "publishedAt": "2024-09-28T16:00:00Z",
      "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "title": "100 Identical Twins Fight For $250,000",
      "description": "I’ve never seen this many twins in one place before lol\nOur brand new flavor is here: Cookies & Creme, made with rich chocolatey filling, studded with crunchy cookie pieces and real creamy white chocolate. Now available at Walmart & Target! https://feastables.com/products/cookies-creme\n\nLunch just got better. #LeaveNoCrumbs https://lunchly.com/pages/lunchly-locator\n\nNew Merch - https://mrbeast.store\n\nCheck out Viewstats! - https://www.viewstats.com/\n\nSUBSCRIBE OR I TAKE YOUR DOG\n╔═╦╗╔╦╗╔═╦═╦╦╦╦╗╔═╗\n║╚╣║║║╚╣╚╣╔╣╔╣║╚╣═╣ \n╠╗║╚╝║║╠╗║╚╣║║║║║═╣\n╚═╩══╩═╩═╩═╩╝╚╩═╩═╝\n\nFor any questions or inquiries regarding this video, please reach out to chucky@mrbeastbusiness.com\n\nMusic Provided by https://www.extrememusic.com\n\n----------------------------------------------------------------\nfollow all of these or i will kick you\n\n• Facebook - https://www.facebook.com/MrBeast6000/\n• Twitter - https://twitter.com/MrBeast\n•  Instagram - https://www.instagram.com/mrbeast\n•  Im Hiring! - https://www.mrbeastjobs.com/",
      "thumbnails": {
        "default": {
          "url": "https://i.ytimg.com/vi/snX5YyflrGw/default.jpg",
          "width": 120,
          "height": 90
        },
        "medium": {
          "url": "https://i.ytimg.com/vi/snX5YyflrGw/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        "high": {
          "url": "https://i.ytimg.com/vi/snX5YyflrGw/hqdefault.jpg",
          "width": 480,
          "height": 360
        },
        "standard": {
          "url": "https://i.ytimg.com/vi/snX5YyflrGw/sddefault.jpg",
          "width": 640,
          "height": 480
        },
        "maxres": {
          "url": "https://i.ytimg.com/vi/snX5YyflrGw/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        }
      },
      "channelTitle": "MrBeast",
      "categoryId": "24",
      "defaultLanguage": "en",
      "defaultAudioLanguage": "en",
      "viewCount": "16837247",
      "likeCount": "937850",
      "commentCount": "4378",
      "topicCategories": [
        "https://en.wikipedia.org/wiki/Entertainment",
        "https://en.wikipedia.org/wiki/Television_program"
      ],
      "uploadStatus": "processed",
      "privacyStatus": "public",
      "license": "youtube",
      "embeddable": true,
      "publicStatsViewable": true,
      "madeForKids": false,
      "hasPaidProductPlacement": false,
      "categoryTitle": "Entertainment",
      "duration": "PT35M40S",
      "parsedDuration": 2140
    },
    {
      "id": "9ZXzsjeRtdk",
      "publishedAt": "2024-09-28T15:00:25Z",
      "channelId": "UCnmGIkw-KdI0W5siakKPKog",
      "title": "I Tried Every Airbnb Category",
      "description": "OMG! a rat!",
      "thumbnails": {
        "default": {
          "url": "https://i.ytimg.com/vi/9ZXzsjeRtdk/default.jpg",
          "width": 120,
          "height": 90
        },
        "medium": {
          "url": "https://i.ytimg.com/vi/9ZXzsjeRtdk/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        "high": {
          "url": "https://i.ytimg.com/vi/9ZXzsjeRtdk/hqdefault.jpg",
          "width": 480,
          "height": 360
        },
        "standard": {
          "url": "https://i.ytimg.com/vi/9ZXzsjeRtdk/sddefault.jpg",
          "width": 640,
          "height": 480
        },
        "maxres": {
          "url": "https://i.ytimg.com/vi/9ZXzsjeRtdk/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        }
      },
      "channelTitle": "Ryan Trahan",
      "tags": [
        "Ryan",
        "Trahan",
        "airbnb",
        "I tried every airbnb category",
        "weird hotel",
        "I stayed in"
      ],
      "categoryId": "24",
      "defaultAudioLanguage": "en",
      "viewCount": "1434842",
      "likeCount": "82676",
      "commentCount": "6748",
      "topicCategories": [
        "https://en.wikipedia.org/wiki/Lifestyle_(sociology)",
        "https://en.wikipedia.org/wiki/Tourism"
      ],
      "uploadStatus": "processed",
      "privacyStatus": "public",
      "license": "youtube",
      "embeddable": true,
      "publicStatsViewable": true,
      "madeForKids": false,
      "hasPaidProductPlacement": false,
      "categoryTitle": "Entertainment",
      "duration": "PT27M15S",
      "parsedDuration": 1635
    },
    {
      "id": "QMe-ce78GJk",
      "publishedAt": "2024-09-27T22:33:10Z",
      "channelId": "UCXoMM35ugF5iOzAEb-PmfRA",
      "title": "Hurricane Helene Historic Storm Surge Devastates Cedar Key, Florida",
      "description": "Stop data brokers from exposing your personal information. Go to my sponsor https://aura.com/jp to get a 14-day free trial and see how much of yours is being sold!\n\nWitness the full fury of Hurricane Helene as it slams into Cedar Key, Florida! This powerful Category 4 storm unleashes a historic storm surge, causing widespread devastation. Homes and businesses are ripped apart, leaving generations of residents in shock. Many have never seen a surge this high, even those whose families have lived in Cedar Key since the 1800s.\n\nThis video documents the destruction and the heartbreak left in the wake of Hurricane Helene.\n\n00:00 Intro\n01:35 Before the Hurricane\n02:24 Storm surge begins\n03:37 Peak storm surge\n06:59 The morning after at the Faraway Inn\n08:22 Historic downtown lost a lot of history\n10:25 Cedar Key's future",
      "thumbnails": {
        "default": {
          "url": "https://i.ytimg.com/vi/QMe-ce78GJk/default.jpg",
          "width": 120,
          "height": 90
        },
        "medium": {
          "url": "https://i.ytimg.com/vi/QMe-ce78GJk/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        "high": {
          "url": "https://i.ytimg.com/vi/QMe-ce78GJk/hqdefault.jpg",
          "width": 480,
          "height": 360
        },
        "standard": {
          "url": "https://i.ytimg.com/vi/QMe-ce78GJk/sddefault.jpg",
          "width": 640,
          "height": 480
        },
        "maxres": {
          "url": "https://i.ytimg.com/vi/QMe-ce78GJk/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        }
      },
      "channelTitle": "Jonathan Petramala",
      "tags": [
        "hurricane helene",
        "hurricane storm surge",
        "hurricane damage",
        "category 4 hurricane footage",
        "category 4 hurricane",
        "storm surge",
        "major hurricane helene",
        "florida hurricane",
        "natural disaster",
        "cedar key",
        "cedar key florida",
        "cedar key hurricane damage",
        "devastation in cedar key",
        "hurricane helene live",
        "hurricane",
        "reed timmer",
        "ryan hall",
        "ryan hall y'all",
        "hurricane hits florida",
        "storm surge florida",
        "storm surge video"
      ],
      "categoryId": "25",
      "defaultAudioLanguage": "en-US",
      "viewCount": "2092695",
      "likeCount": "25252",
      "commentCount": "3703",
      "uploadStatus": "processed",
      "privacyStatus": "public",
      "license": "youtube",
      "embeddable": true,
      "publicStatsViewable": true,
      "madeForKids": false,
      "hasPaidProductPlacement": true,
      "categoryTitle": "News & Politics",
      "duration": "PT11M32S",
      "parsedDuration": 692
    },
    {
      "id": "BLCOufzhaMY",
      "publishedAt": "2024-09-28T15:01:07Z",
      "channelId": "UCo8bcnLyZH8tBIH9V1mLgqQ",
      "title": "We Made It This Far",
      "description": "Thank you for 10 years!!\nInstagram ➤ https://www.instagram.com/theodd1sout/\nTikTok ➤ https://www.tiktok.com/@theoddtiktoksout\nTwitter ➤ https://twitter.com/theodd1sout\n\nART TEAM:\nEmilee Dummer ➤ https://www.instagram.com/edummerart/\nKelly Jensen ➤ https://www.instagram.com/kelly_anne_art/\nClaire Anne ➤ https://www.instagram.com/claireanneillustration\nAmelia Rosenbalm ➤ https://www.instagram.com/galloame/\nRikikuniyuki_art ➤ https://www.instagram.com/rikikuniyuki_art/",
      "thumbnails": {
        "default": {
          "url": "https://i.ytimg.com/vi/BLCOufzhaMY/default.jpg",
          "width": 120,
          "height": 90
        },
        "medium": {
          "url": "https://i.ytimg.com/vi/BLCOufzhaMY/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        "high": {
          "url": "https://i.ytimg.com/vi/BLCOufzhaMY/hqdefault.jpg",
          "width": 480,
          "height": 360
        },
        "standard": {
          "url": "https://i.ytimg.com/vi/BLCOufzhaMY/sddefault.jpg",
          "width": 640,
          "height": 480
        },
        "maxres": {
          "url": "https://i.ytimg.com/vi/BLCOufzhaMY/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        }
      },
      "channelTitle": "TheOdd1sOut",
      "categoryId": "23",
      "defaultAudioLanguage": "en",
      "viewCount": "883139",
      "likeCount": "127631",
      "commentCount": "11297",
      "topicCategories": [
        "https://en.wikipedia.org/wiki/Entertainment",
        "https://en.wikipedia.org/wiki/Film"
      ],
      "uploadStatus": "processed",
      "privacyStatus": "public",
      "license": "youtube",
      "embeddable": true,
      "publicStatsViewable": true,
      "madeForKids": false,
      "hasPaidProductPlacement": false,
      "categoryTitle": "Comedy",
      "duration": "PT1M39S",
      "parsedDuration": 99
    },
    {
      "id": "V9PVRfjEBTI",
      "publishedAt": "2024-09-27T15:00:38Z",
      "channelId": "UCDGmojLIoWpXok597xYo8cg",
      "title": "Billie Eilish - BIRDS OF A FEATHER (Official Music Video)",
      "description": "Listen to HIT ME HARD AND SOFT: http://BillieEilish.lnk.to/HITMEHARDARDANDSOFT\nDownload BIRDS OF A FEATHER Live from Billie’s Amazon Music Songline performance: https://billieeilish.lnk.to/BIRDSOFAFEATHER-AMAZONDOWNLOAD \nGet tickets: https://BillieEilish.lnk.to/TourDates \n\n Follow Billie Eilish: \n\nTikTok: https://BillieEilish.lnk.to/TikTok \nInstagram: https://BillieEilish.lnk.to/Instagram \nFacebook: https://BillieEilish.lnk.to/Facebook \nTwitter: https://BillieEilish.lnk.to/Twitter \nYouTube:    / billieeilish   \nWhatsApp: https://BillieEilish.lnk.to/WhatsApp \nEmail: https://BillieEilish.lnk.to/SignUp \nStore: https://BillieEilish.lnk.to/Store \nCell: +1 (310) 807-3956\n\nMusic video by Billie Eilish performing BIRDS OF A FEATHER.© 2024 Darkroom/Interscope Records",
      "thumbnails": {
        "default": {
          "url": "https://i.ytimg.com/vi/V9PVRfjEBTI/default.jpg",
          "width": 120,
          "height": 90
        },
        "medium": {
          "url": "https://i.ytimg.com/vi/V9PVRfjEBTI/mqdefault.jpg",
          "width": 320,
          "height": 180
        },
        "high": {
          "url": "https://i.ytimg.com/vi/V9PVRfjEBTI/hqdefault.jpg",
          "width": 480,
          "height": 360
        },
        "standard": {
          "url": "https://i.ytimg.com/vi/V9PVRfjEBTI/sddefault.jpg",
          "width": 640,
          "height": 480
        },
        "maxres": {
          "url": "https://i.ytimg.com/vi/V9PVRfjEBTI/maxresdefault.jpg",
          "width": 1280,
          "height": 720
        }
      },
      "channelTitle": "BillieEilishVEVO",
      "tags": [
        "Billie Eilish",
        "Darkroom/Interscope Records",
        "Alternative"
      ],
      "categoryId": "10",
      "defaultAudioLanguage": "en",
      "viewCount": "5055455",
      "likeCount": "567926",
      "commentCount": "27854",
      "topicCategories": [
        "https://en.wikipedia.org/wiki/Independent_music",
        "https://en.wikipedia.org/wiki/Music",
        "https://en.wikipedia.org/wiki/Pop_music"
      ],
      "uploadStatus": "processed",
      "privacyStatus": "public",
      "license": "youtube",
      "embeddable": true,
      "publicStatsViewable": true,
      "madeForKids": false,
      "hasPaidProductPlacement": false,
      "categoryTitle": "Music",
      "duration": "PT3M51S",
      "parsedDuration": 231
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

hl
enum<string>

The language to retrieve localized data in.

Available options:
en,
es,
de,
fr,
ja,
pt,
tr,
it,
fa,
nl,
af,
am,
ar,
as,
az,
be,
bg,
bn,
bs,
ca,
cs,
da,
el,
en-GB,
en-IN,
es-419,
es-US,
et,
eu,
fi,
fil,
fr-CA,
gl,
gu,
hi,
hr,
hu,
hy,
id,
is,
iw,
ka,
kk,
km,
kn,
ko,
ky,
lo,
lt,
lv,
mk,
ml,
mn,
mr,
ms,
my,
no,
ne,
or,
pa,
pl,
pt-PT,
ro,
ru,
si,
sk,
sl,
sq,
sr-Latn,
sr,
sv,
sw,
ta,
te,
th,
uk,
ur,
uz,
vi,
zh-CN,
zh-HK,
zh-TW,
zu
regionCode
enum<string>

Instructs the API to return results for videos that can be viewed in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code.

Available options:
AD,
AE,
AF,
AG,
AI,
AL,
AM,
AN,
AO,
AQ,
AR,
AS,
AT,
AU,
AW,
AX,
AZ,
BA,
BB,
BD,
BE,
BF,
BG,
BH,
BI,
BJ,
BM,
BN,
BO,
BR,
BS,
BT,
BV,
BW,
BY,
BZ,
CA,
CC,
CD,
CF,
CG,
CH,
CI,
CK,
CL,
CM,
CN,
CO,
CR,
CU,
CV,
CX,
CY,
CZ,
DE,
DJ,
DK,
DM,
DO,
DZ,
EC,
EE,
EG,
EH,
ER,
ES,
ET,
EU,
FI,
FJ,
FK,
FM,
FO,
FR,
GA,
GB,
GD,
GE,
GF,
GG,
GH,
GI,
GL,
GM,
GN,
GP,
GQ,
GR,
GS,
GT,
GU,
GW,
GY,
HK,
HM,
HN,
HR,
HT,
HU,
ID,
IE,
IL,
IM,
IN,
IO,
IQ,
IR,
IS,
IT,
JE,
JM,
JO,
JP,
KE,
KG,
KH,
KI,
KM,
KN,
KP,
KR,
KW,
KY,
KZ,
LA,
LB,
LC,
LI,
LK,
LR,
LS,
LT,
LU,
LV,
LY,
MA,
MC,
MD,
ME,
MG,
MH,
MK,
ML,
MM,
MN,
MO,
MP,
MQ,
MR,
MS,
MT,
MU,
MV,
MW,
MX,
MY,
MZ,
NA,
NC,
NE,
NF,
NG,
NI,
NL,
NO,
NP,
NR,
NU,
NZ,
OM,
PA,
PE,
PF,
PG,
PH,
PK,
PL,
PM,
PN,
PR,
PS,
PT,
PW,
PY,
QA,
RE,
RO,
RS,
RU,
RW,
SA,
SB,
SC,
SD,
SE,
SG,
SH,
SI,
SJ,
SK,
SL,
SM,
SN,
SO,
SR,
ST,
SV,
SY,
SZ,
TC,
TD,
TF,
TG,
TH,
TJ,
TK,
TL,
TM,
TN,
TO,
TR,
TT,
TV,
TW,
TZ,
UA,
UG,
UM,
US,
UY,
UZ,
VA,
VC,
VE,
VG,
VI,
VN,
VU,
WF,
WS,
XK,
YE,
YT,
ZA,
ZM,
ZW
videoCategoryId
enum<string>

Filters video search results based on their category.

Available options:
0,
1,
2,
10,
15,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30,
31,
32,
33,
34,
35,
36,
37,
38,
39,
40,
41,
42,
43,
44
fields
string

An array of fields to include in the response. If not provided, all fields will be returned.

maxResults
string
default:50

Specifies the maximum number of items that should be returned in the result set.

pageToken
string

The page token to get the next page for the search results. If not provided, the first page will be returned.

Response

200
application/json
Successful response
totalResults
number
required

Total number of popular videos returned.

data
object[]
required

Array of popular video objects.