> ## Documentation Index > Fetch the complete documentation index at: https://docs.zilodata.com/llms.txt > Use this file to discover all available pages before exploring further. # Get trending videos > Get trending videos based on geographical location ## OpenAPI ````yaml api-reference/youtube-openapi.json get /api/v1/trending/video openapi: 3.1.0 info: title: YouTube APIs description: YouTube API Documentation version: 1.0.0 servers: - url: https://youtube-scraper-api-v21.p.rapidapi.com security: [] paths: /api/v1/trending/video: get: tags: - Trending summary: Get trending videos description: Get trending videos based on geographical location operationId: getApiV1TrendingVideo parameters: - in: query name: countryCode schema: type: string default: us description: Country code for trending videos/ filter by country example: us enum: - us - ar - au - at - be - bo - br - ca - cl - co - cr - cz - dk - do - ec - eg - sv - ee - fi - fr - de - gt - hn - hk - hu - is - in - id - ie - il - it - jp - ke - lu - my - mx - nl - nz - ni - ng - 'no' - pa - py - pe - ph - pl - pt - ro - ru - sa - rs - sg - za - kr - es - se - ch - tw - tz - th - tr - ug - ua - ae - gb - uy - vn - zw - in: query name: gl schema: type: string default: US description: Geographical code example: US enum: - 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 - in: query name: hl schema: type: string description: Language code example: en enum: - 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 default: en responses: '200': description: Success content: application/json: schema: type: object properties: message: type: string example: Success statusCode: type: number example: 200 pagination: type: object properties: total: type: number example: 100 hasMore: type: boolean example: true continuation: type: - string - 'null' description: Continuation token for pagination example: CDsQ8FsiEwje95_F1pmRAxXlsykDHUX data: type: object properties: contents: type: array items: type: object properties: author: type: object properties: avatar: type: object properties: url: type: string description: Author avatar image URL example: >- https://i.ytimg.com/vi/JednRKQYhC4/default.jpg width: type: number description: Avatar image width in pixels example: 120 height: type: number description: Avatar image height in pixels example: 90 required: - url - width - height description: Author avatar image information name: type: string description: Author/channel name example: Alofoke Music required: - avatar - name description: Video author/channel information videoId: type: string description: YouTube video ID example: JednRKQYhC4 channelId: type: string description: YouTube channel ID example: UCeDlzhpU8NZAlL1rsXp54zQ thumbnails: type: array items: type: object properties: url: type: string description: Thumbnail image URL example: >- https://i.ytimg.com/vi/JednRKQYhC4/default.jpg width: type: number description: Thumbnail image width in pixels example: 120 height: type: number description: Thumbnail image height in pixels example: 90 required: - url - width - height description: Thumbnail image information description: >- Array of video thumbnail images in different sizes example: - url: >- https://i.ytimg.com/vi/JednRKQYhC4/default.jpg width: 120 height: 90 - url: >- https://i.ytimg.com/vi/JednRKQYhC4/mqdefault.jpg width: 320 height: 180 - url: >- https://i.ytimg.com/vi/JednRKQYhC4/hqdefault.jpg width: 480 height: 360 - url: >- https://i.ytimg.com/vi/JednRKQYhC4/sddefault.jpg width: 640 height: 480 publishedTimeText: type: string description: Human-readable published time text example: 2 days ago releaseDate: type: object properties: year: type: number description: Release year example: 2025 month: type: number description: Release month (1-12) example: 11 day: type: number description: Release day (1-31) example: 29 required: - year - month - day description: Video release date title: type: string description: Video title example: >- MICHAEL FLORES X DANI BARRANCO X ALOFOKE MUSIC - AGUITA E COCO duration: type: string description: Video duration in format MM:SS or HH:MM:SS example: '2:22' songwriters: type: array items: type: string description: Array of songwriter names example: [] songProducers: type: array items: type: string description: Array of producer names example: [] url: type: string description: YouTube video watch URL example: https://www.youtube.com/watch?v=JednRKQYhC4 required: - author - videoId - channelId - thumbnails - publishedTimeText - releaseDate - title - duration - songwriters - songProducers - url description: Array of trending video results required: - contents required: - data '400': description: Bad Request content: application/json: schema: type: object properties: message: type: string example: Bad request '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Invalid API key '403': description: Not Found content: application/json: schema: type: object properties: message: type: string example: >- You are not subscribed to this API, please subscribe before using '500': description: Internal Server Error content: application/json: schema: type: object properties: success: type: boolean example: false message: type: string example: Internal Server Error status_code: type: number example: 500 cost: type: number example: 0 explain: type: string example: Internal Server Error security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: x-rapidapi-key description: API Key ````