CHchartmetric
Artist

Artist Fan Metrics by Source

Artist's fan-metrics time series for a given source. Pass field to target a single metric, or omit it to receive the source's default fields. Each metric resolves to an array of time-series points with value, timestp, diff counters, and an interpolated flag (response may omit points on missing days; see the interpolated: true|false flag on each point).

Valid field values per source:

sourceValid field values
spotifyfollowers, popularity, listeners
deezerfans
facebooklikes, talks
twitterfollowers, retweets
youtube_channel (artist's channel)subscribers, views, comments, videos
youtube_artist (channel + featured videos)daily_views, monthly_views
instagramfollowers
wikipediaviews
bandsintownfollowers
soundcloudfollowers
tiktokfollowers, likes
twitchfollower_count, monthly_viewer_hours, weekly_viewer_hours
linelikes
melonfans
bilibilifollowers
snapstory_views, spotlite_views, snap_followers

If field is omitted, the handler returns the source's default fields.

Geo filters per (source, field): these combinations are enforced — passing city_id or code2 outside the table returns 400.

sourcefieldComparable by city (city_id)Comparable by country (code2)
instagramfollowers✅✅
spotifylisteners✅
tiktokfollowers✅
youtube_channelsubscribers✅
youtube_artistdaily_views✅✅
youtube_artistmonthly_views✅✅
get/api/artist/{id}/stat/{source}

Request

Path parameters

string required
OR
integer required
source'spotify' | 'deezer' | 'facebook' | 'twitter' | 'instagram' | 'youtube_channel' | 'youtube_artist' | 'wikipedia' | 'bandsintown' | 'soundcloud' | 'tiktok' | 'twitch' | 'line' | 'melon' | 'bilibili' | 'snap' required

Data source. One of spotify, deezer, facebook, twitter, instagram, youtube_channel, youtube_artist, wikipedia, bandsintown, soundcloud, tiktok, twitch, line, melon, bilibili, snap. Each source supports a different default field set when field is omitted.

Query parameters

sincestring date-time

Start of the date range in ISO format (e.g. '2025-11-01'). Defaults to 20 days ago. Ignored when latest=true.

untilstring date-time

End of the date range in ISO format (e.g. '2025-11-01'). Defaults to today. Ignored when latest=true.

field'views' | 'subscribers' | 'likes' | 'followers' | 'talks' | 'favorites' | 'friends' | 'popularity' | 'listeners' | 'retweets' | 'comments' | 'videos' | 'followers_to_listeners_ratio' | 'daily_views' | 'monthly_views' | 'follower_count' | 'monthly_viewer_hours' | 'weekly_viewer_hours' | 'artist_likes' | 'fans' | 'story_views' | 'spotlite_views'

Specific stat from source (e.g. followers, popularity, listeners, talks, subscribers). When omitted, returns the source-specific default field set.

latestboolean

If true, returns only the most recent data point and ignores since/until.

interpolatedboolean

If true, fill missing days with linear-interpolated values (average of bracketing observations). Not applicable to Spotify popularity or some interpolation-incompatible metrics.

isDomainIdboolean

If true, treat id as a domain-specific ID rather than a Chartmetric artist ID. Defaults to false.

city_idinteger

Chartmetric city ID for city-scoped metrics. Mutually exclusive with code2. Only valid for (source, field) combos that support city comparison.

code2string

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

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.