YouTube Views & Market Coverage

Artist's YouTube-for-Artist views snapshot split by top cities / countries, alongside competitor marketInsights and the artist's aggregate monthly views for the requested date. Each insight entry carries a 28-day trend series. Cities are decorated with continent. Market coverage for top 100 cities is available only for dates on/after 2024-05-24.

Path Parameters

id
Type: integer
min:
2
max:
2147483647
required

Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.
enum
const:
1
values
1

Query Parameters

date
Type: string Format: date

Snapshot date in ISO format (e.g. '2024-12-01'). Top-100-cities coverage is available only on/after 2024-05-24. When omitted, returns the most recent snapshot.

Responses

application/json

get/api/artist/{id}/market-coverage-views/youtube

curl https://api.chartmetric.com/api/artist/2/market-coverage-views/youtube \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": {
    "insights": {
      "cities": [
        {
          "rank": 1,
          "value": 12345678,
          "timestp": "2025-01-15",
          "params_id": "207359",
          "name": "Los Angeles",
          "lat": 34.05223,
          "lng": -118.24368,
          "code2": "US",
          "city_id": 207359,
          "current_max_count": "15000000",
          "region": "CITY",
          "market_max_cm_artist_id": 12345,
          "market_max_artist_name": "Example Competitor",
          "continent": "NA",
          "trend": [
            {
              "timestp": "2025-01-01",
              "monthlyViews": 10000000
            }
          ]
        }
      ],
      "countries": [
        {
          "rank": 1,
          "value": 50000000,
          "timestp": "2025-01-15",
          "name": "United States",
          "code2": "US",
          "region": "COUNTRY"
        }
      ]
    },
    "marketInsights": {
      "marketCities": [],
      "marketCountries": []
    },
    "artistTotalViews": 1234567890
  }
}

Success