Curator

Get Curator Fan Metrics

Time-series fan metrics for a curator from a given source (one of spotify, facebook, twitter, youtube_channel, instagram, tiktok). Pass field to request a single metric (e.g. followers, likes), or omit it for source defaults: spotify → followers; facebook → followers, likes, talks; twitter → followers; youtube_channel → subscribers, views, videos; instagram → followers; tiktok → followers, likes.

get/api/curator/{platform}/{id}/stat/{source}

Request

Base URL
https://api.chartmetric.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/curator/:platform/:id/stat/:source/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

platform'spotify' | 'itunes' | 'applemusic' | 'deezer' required

Streaming platform of the curator. Allowed: spotify, itunes, applemusic, deezer (itunes and applemusic return the same data).

idinteger required

Chartmetric curator ID.

Social/streaming source for the metric. One of spotify, facebook, twitter, youtube_channel, instagram, tiktok. Pair with field to request a single metric.

Query parameters

sincestring date-time

Lower bound of the date range in ISO format (e.g. '2024-03-05'). Defaults to 20 days ago. Ignored when latest=true.

untilstring date-time

Upper bound of the date range in ISO format (e.g. '2024-03-25'). Defaults to today. Ignored when latest=true.

fieldstring

Specific stat to return from source (e.g. followers, likes). See the operation description for valid (source, field) combinations. If omitted, returns the source defaults.

latestboolean

If true, return only the most recent data point and ignore since/until. Defaults to false.

interpolatedboolean

If true, linearly interpolate between adjacent known data points to fill missing days. Each returned point carries an interpolated boolean. Defaults to false.

Response

Success

Changes

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