> ## 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 artists

> Get trending artists based on geographical location



## OpenAPI

````yaml api-reference/youtube-openapi.json get /api/v1/trending/artist
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/artist:
    get:
      tags:
        - Trending
      summary: Get trending artists
      description: Get trending artists based on geographical location
      operationId: getApiV1TrendingArtist
      parameters:
        - in: query
          name: countryCode
          schema:
            type: string
            default: global
            description: Country code for trending artists/ 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:
                            artistId:
                              type: string
                              description: Artist channel ID
                              example: UCLH5ojAg1XIyxcOCazK4n-Q
                            name:
                              type: string
                              description: Artist name
                              example: Alka Yagnik
                            avatar:
                              type: object
                              properties:
                                url:
                                  type: string
                                  description: Artist avatar image URL
                                  example: >-
                                    https://lh3.googleusercontent.com/_wPXKRCH5rAX8AK1kJZ1bNhSpNyyEgBRNmREdPmLbvTy3sX_ldiKMRYFc5uChygV_KRx_SDrH1KgUifk
                                width:
                                  type: number
                                  description: Avatar image width in pixels
                                  example: 0
                                height:
                                  type: number
                                  description: Avatar image height in pixels
                                  example: 0
                              required:
                                - url
                                - width
                                - height
                              description: Artist avatar image information
                            views:
                              type: number
                              description: Number of artist views
                              example: 476109500
                            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.006110331
                                periodsOnChart:
                                  type: number
                                  description: >-
                                    Number of periods the artist has been on the
                                    chart
                                  example: 480
                              required:
                                - currentPosition
                                - previousPosition
                                - percentViewsChange
                                - periodsOnChart
                              description: Chart position and ranking information
                            channelId:
                              type: string
                              description: YouTube channel ID
                              example: UCLH5ojAg1XIyxcOCazK4n-Q
                            url:
                              type: string
                              description: Artist channel URL
                              example: >-
                                https://www.youtube.com/channel/UCLH5ojAg1XIyxcOCazK4n-Q
                          required:
                            - artistId
                            - name
                            - avatar
                            - views
                            - position
                            - channelId
                            - url
                        description: Array of trending artist 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

````