Get YouTube Top-Artist Chart (weekly)

​

Return the YouTube weekly top-artist chart for a given country_code and date. Each row carries the chart row + per-artist rankStats and viewStats histories, plus image_url hydrated from Artist.getBasicInfoBatch. Data is updated weekly on Thursdays.

Query Parameters
  • country_code
    Type: string
    min length:  
    2
    max length:  
    2
    required

    ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

  • date
    Type: string Format: date-time

    Date for the time-slice (YYYY-MM-DD). Required unless latest=true.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

  • latest
    Type: boolean

    If true, use the most recently available date and ignore date.

Responses
  • application/json
Request Example for get/api/charts/youtube/artists
curl 'https://api.chartmetric.com/api/charts/youtube/artists?country_code=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": 1,
    "data": [
      {
        "cm_artist": 839964,
        "youtube_artist": "/g/11fhvxdh1f",
        "name": "Roddy Ricch",
        "image_url": "https://lh3.googleusercontent.com/a-/AAuE7mD9mk4b9HXoY3SQHbXScUGwoLs_pDjXrA_rG3KP=w60-h60-l90-rj",
        "rank": 1,
        "added_at": "2020-02-06T00:00:00.000Z",
        "velocity": 0,
        "pre_rank": 1,
        "peak_rank": 1,
        "peak_date": "2020-01-09T00:00:00.000Z",
        "time_on_chart": "8",
        "rankStats": [
          {
            "rank": 1,
            "timestp": "2020-01-30T00:00:00.000Z"
          }
        ],
        "viewStats": [
          {
            "views": 18400000,
            "timestp": "2020-01-30T00:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Success