> ## 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 songs > Get trending songs based on geographical location ## OpenAPI ````yaml api-reference/youtube-openapi.json get /api/v1/trending/song 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/song: get: tags: - Trending summary: Get trending songs description: Get trending songs based on geographical location operationId: getApiV1TrendingSong parameters: - in: query name: countryCode schema: type: string default: global description: Country code for trending songs/ filter by country example: global enum: - 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 - in: query name: filterByDate schema: type: string default: '20251106' description: 'Filter by date, format: YYYYMMDD' example: '20251106' format: YYYYMMDD - 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: Artist avatar image URL example: >- https://lh3.googleusercontent.com/1U-1pXbvkpvGXGUIFs5m6RXz4Fmdvqo1zzQw8eY7b4G9iwpE6vaRclt8Ov5CS8ldROIQGu2InpGuSJSW=w180-h180-l90-rj width: type: number description: Avatar image width in pixels example: 180 height: type: number description: Avatar image height in pixels example: 180 required: - url - width - height description: Artist avatar image information name: type: string description: Artist/channel name example: HUNTR/X required: - avatar - name description: Song artist/channel information videoId: type: string description: YouTube video ID example: yebNIHKAC4A channelId: type: string description: YouTube channel ID example: '' thumbnails: type: array items: type: object properties: url: type: string description: Thumbnail image URL example: >- https://lh3.googleusercontent.com/1U-1pXbvkpvGXGUIFs5m6RXz4Fmdvqo1zzQw8eY7b4G9iwpE6vaRclt8Ov5CS8ldROIQGu2InpGuSJSW=w180-h180-l90-rj width: type: number description: Thumbnail image width in pixels example: 180 height: type: number description: Thumbnail image height in pixels example: 180 required: - url - width - height description: Thumbnail image information description: >- Array of song thumbnail images in different sizes example: - url: >- https://lh3.googleusercontent.com/1U-1pXbvkpvGXGUIFs5m6RXz4Fmdvqo1zzQw8eY7b4G9iwpE6vaRclt8Ov5CS8ldROIQGu2InpGuSJSW=w180-h180-l90-rj width: 180 height: 180 publishedTimeText: type: string description: Human-readable published time text example: 5 months ago releaseDate: type: object properties: year: type: number description: Release year example: 2025 month: type: number description: Release month (1-12) example: 6 day: type: number description: Release day (1-31) example: 19 required: - year - month - day description: Song release date title: type: string description: Song title example: Golden views: type: number description: Number of video views example: 81040900 songwriters: type: array items: type: string description: Array of songwriter names example: - EJAE - Mark Sonnenblick - Joong Gyu Kwak songProducers: type: array items: type: string description: Array of producer names example: - IDO - '24' - TEDDY - Ian Eisendrath position: type: object properties: currentPosition: type: number description: Current position in the chart example: 1 previousPosition: type: - number - 'null' description: Previous position in the chart example: 1 percentViewsChange: type: - number - 'null' description: >- Percentage change in views compared to previous period example: -0.05360259 periodsOnChart: type: number description: >- Number of periods the song has been on the chart example: 23 required: - currentPosition - previousPosition - percentViewsChange - periodsOnChart description: Chart position and ranking information url: type: string description: YouTube video watch URL example: https://www.youtube.com/watch?v=yebNIHKAC4A required: - author - videoId - channelId - thumbnails - publishedTimeText - releaseDate - title - views - songwriters - songProducers - position - url description: Array of trending song 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 ````