---
title: "Get current stats (premium)"
method: GET
path: "/api/v2/artist/{uuid}/current/stats"
tags: ["Artist"]
---

# Get current stats (premium)

`GET /api/v2/artist/{uuid}/current/stats`

## Path parameters

- `uuid` string, required

## Query parameters

- `period` string

## Response `200`

Current stats response

- CurrentStatsResponse
  - `related` ArtistLightStat[]
    - `uuid` string
    - `slug` string
    - `name` string
    - `appUrl` string
    - `imageUrl` string
    - `period` integer
  - `social` StatPlot[]
    - `platform` string
    - `value` number
    - `date` string, date-time
    - `evolution` number
    - `percentEvolution` number
  - `streaming` StatPlot[]
    - `platform` string
    - `value` number
    - `date` string, date-time
    - `evolution` number
    - `percentEvolution` number
  - `popularity` StatPlot[]
    - `platform` string
    - `value` number
    - `date` string, date-time
    - `evolution` number
    - `percentEvolution` number
  - `retention` StatPlot[]
    - `platform` string
    - `value` number
    - `date` string, date-time
    - `evolution` number
    - `percentEvolution` number
  - `score` StatPlot[]
    - `platform` string
    - `value` number
    - `date` string, date-time
    - `evolution` number
    - `percentEvolution` number

## Other responses

- `401` — You are not logged in
- `403` — This endpoint is not included in your current plan, reach out to help@soundcharts.com if you want access.
- `404` — Artist not found

---

[API](https://skmtc.net/soundcharts/apis/soundcharts-api.md) · [All operations](https://skmtc.net/soundcharts/apis/soundcharts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/soundcharts/soundcharts-api/revisions/3c3527dd7996/schema)