Skip to main content
GET
/
api
/
v1
/
search
Search
curl --request GET \
  --url https://youtube.zilodata.com/api/v1/search \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "contents": [
      {
        "author": {
          "avatar": {
            "url": "https://yt3.ggpht.com/Lw8D7ol21pLxWEDvnIwcV0DsXIA1d_6DK4_wlkTtaP7SEGBg-2FLRDvs57NPnE1DcNarWPkQpvs=s88-c-k-c0x00ffffff-no-rj",
            "width": 68,
            "height": 68
          },
          "name": "Luis Fonsi",
          "badges": [
            {
              "type": "AUDIO_BADGE",
              "text": "Official Artist Channel"
            }
          ]
        },
        "videoId": "kJQP7kiw5Fk",
        "channelId": "UCxoq-PAQeAdk_zyg8YS0JqA",
        "thumbnails": [
          {
            "url": "https://i.ytimg.com/vi/kJQP7kiw5Fk/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLCj96Jh8NkTqgJqkcXFQKo7MnO30g",
            "width": 360,
            "height": 202
          },
          {
            "url": "https://i.ytimg.com/vi/kJQP7kiw5Fk/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBH3EhyCr_aZDODXzXVDL-taforQw",
            "width": 720,
            "height": 404
          }
        ],
        "publishedTimeText": "8 years ago",
        "title": "Luis Fonsi - Despacito ft. Daddy Yankee",
        "views": 8871198622,
        "duration": "4:42",
        "url": "https://www.youtube.com/watch?v=kJQP7kiw5Fk"
      }
    ],
    "refinements": [
      "video",
      "music",
      "image"
    ]
  },
  "message": "Success",
  "statusCode": 200,
  "pagination": {
    "total": 100,
    "hasMore": true,
    "paginationToken": "CDsQ8FsiEwje95_F1pmRAxXlsykDHUX"
  }
}

Authorizations

​
x-api-key
string
header
required

API Key

Query Parameters

​
keyword
string
required

Search keyword

Example:

"funny videos"

​
geoCode
enum<string>
default:US

Geographical code

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"

​
uploadDate
enum<string>
default:1_HOUR_AGO

Upload date

Available options:
1_HOUR_AGO,
TODAY,
THIS_WEEK,
THIS_MONTH,
THIS_YEAR
Example:

"1_HOUR_AGO"

​
type
enum<string>
default:VIDEO

Type

Available options:
VIDEO,
MOVIE
Example:

"VIDEO"

​
language
enum<string>
default:en

Language

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"

​
paginationToken
string

Pagination token

Example:

""

Response

Success

​
data
object
required
​
message
string
Example:

"Success"

​
statusCode
number
Example:

200

​
pagination
object