Skip to main content
GET
/
api
/
v1
/
trending
/
top-video
Get top trending videos
curl --request GET \
  --url https://youtube.zilodata.com/api/v1/trending/top-video \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "contents": [
      {
        "author": {
          "avatar": {
            "url": "https://i.ytimg.com/vi/7CGKeID7nRc/default.jpg",
            "width": 120,
            "height": 90
          },
          "name": "GIMS"
        },
        "videoId": "7CGKeID7nRc",
        "channelId": "UCCB1Byx5yTbLpQaV-rlfmtA",
        "thumbnails": [
          {
            "url": "https://i.ytimg.com/vi/7CGKeID7nRc/default.jpg",
            "width": 120,
            "height": 90
          },
          {
            "url": "https://i.ytimg.com/vi/7CGKeID7nRc/mqdefault.jpg",
            "width": 320,
            "height": 180
          },
          {
            "url": "https://i.ytimg.com/vi/7CGKeID7nRc/hqdefault.jpg",
            "width": 480,
            "height": 360
          },
          {
            "url": "https://i.ytimg.com/vi/7CGKeID7nRc/sddefault.jpg",
            "width": 640,
            "height": 480
          }
        ],
        "publishedTimeText": "3 months ago",
        "releaseDate": {
          "year": 2025,
          "month": 8,
          "day": 16
        },
        "title": "PARISIENNE",
        "views": 184560,
        "duration": "2:40",
        "songwriters": [
          "A.R. Rahman",
          "Balaji"
        ],
        "songProducers": [],
        "position": {
          "currentPosition": 1,
          "previousPosition": 1,
          "percentViewsChange": -0.034010615,
          "periodsOnChart": 15
        },
        "url": "https://www.youtube.com/watch?v=7CGKeID7nRc"
      }
    ]
  },
  "message": "Success",
  "statusCode": 200,
  "pagination": {
    "total": 100,
    "hasMore": true,
    "paginationToken": "CDsQ8FsiEwje95_F1pmRAxXlsykDHUX"
  }
}

Authorizations

​
x-api-key
string
header
required

API Key

Query Parameters

​
filterByType
enum<string>
default:DAILY

Sort by

Available options:
DAILY,
WEEKLY
Example:

"DAILY"

​
filterByDate
string<YYYYMMDD>
default:20251106

Filter by date, format: YYYYMMDD

Example:

"20251106"

​
countryCode
enum<string>
default:global

Country code for top trending videos/ filter by country

Available options:
global,
us,
ar,
au,
at,
be,
bo,
br,
ca,
cl,
co,
cr,
cz,
dk,
do,
ec,
eg,
sv,
ee,
fi,
fr,
de,
gt,
hn,
hu,
is,
in,
id,
ie,
il,
it,
jp,
ke,
lu,
mx,
nl,
nz,
ni,
ng,
no,
pa,
py,
pe,
pl,
pt,
ro,
ru,
sa,
rs,
za,
kr,
es,
se,
ch,
tz,
tr,
ug,
ua,
ae,
gb,
uy,
zw
Example:

"global"

​
geoCode
enum<string>
default:US

Geographical code for top trending videos

Available options:
US,
AE,
AR,
AT,
AU,
AZ,
BD,
BE,
BG,
BR,
CA,
CH,
CL,
CO,
CZ,
DE,
DK,
DO,
DZ,
EC,
EG,
ES,
FI,
FR,
GB,
GH,
GR,
GT,
HK,
HN,
HR,
HU,
ID,
IE,
IL,
IN,
IQ,
IT,
JP,
KE,
KR,
LB,
LT,
LV,
MA,
MX,
MY,
NG,
NL,
NO,
NZ,
PE,
PH,
PK,
PL,
PT,
RO,
RU,
SA,
SE,
SG,
TH,
TR,
TW,
UA,
VE,
VN,
ZA
Example:

"US"

​
language
enum<string>
default:en

Language code

Available options:
ar,
az,
bg,
bn,
cs,
da,
de,
el,
en,
en-GB,
en-IE,
en-NZ,
en-SG,
es,
es-419,
fi,
fil,
fr,
he,
hi,
hr,
hu,
id,
it,
ja,
ko,
lt,
lv,
ms,
nl,
no,
pl,
pt-BR,
pt-PT,
ro,
ru,
sv,
th,
tr,
uk,
ur,
vi,
zh-Hant
Example:

"en"

Response

Success

​
data
object
required
​
message
string
Example:

"Success"

​
statusCode
number
Example:

200

​
pagination
object