---
title: "Get Curator Fan Metrics"
method: GET
path: "/api/curator/{platform}/{id}/stat/{source}"
tags: ["Curator"]
---

# Get Curator Fan Metrics

`GET /api/curator/{platform}/{id}/stat/{source}`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/curator/{platform}/{id}/stat/{source}`
- 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)

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`.

## 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).
- `id` integer, required: Chartmetric curator ID.
- `source` 'spotify' | 'facebook' | 'twitter' | 'youtube_channel' | 'instagram' | 'tiktok', required: 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

- `since` string, 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`.
- `until` string, date-time: Upper bound of the date range in ISO format (e.g. '2024-03-25'). Defaults to today. Ignored when `latest=true`.
- `field` string: 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.
- `latest` boolean: If true, return only the most recent data point and ignore `since`/`until`. Defaults to false.
- `interpolated` boolean: If true, linearly interpolate between adjacent known data points to fill missing days. Each returned point carries an `interpolated` boolean. Defaults to false.

## Response `200`

Success

- object
  - `obj` object
    - `link` string, nullable: URL on `source` associated with the curator (e.g. the curator's Facebook page), when known.
    - `followers` object[]: Time series of follower counts for this curator on `source`.
      - `value` number, float, nullable: Metric value at this data point.
      - `timestp` string, date-time, nullable: ISO timestamp at which this data point was recorded.
      - `flags` boolean, nullable: True if a post was made on `source` on this date (e.g. a Facebook post). Helpful for explaining spikes in nearby metrics.
      - `diff` number, float, nullable: Difference between this data point and the previous one in the array. Always null for the first point.
      - `weekly_diff` number, float, nullable: Difference between `value` today and 7 days ago.
      - `weekly_diff_percent` number, float, nullable: Percentage change in `value` over the past 7 days (e.g. `1.39` means +1.39%).
      - `monthly_diff` number, float, nullable: Difference between `value` today and 28 days ago.
      - `monthly_diff_percent` number, float, nullable: Percentage change in `value` over the past 28 days (e.g. `1.39` means +1.39%).
      - `daily_diff` number, float, nullable: Day-over-day difference in `value`. Populated only when `interpolated=true`; when `interpolated=false` the value is returned in `diff` instead. Not applicable for Spotify popularity.
      - `interpolated` boolean, nullable: True if this data point was interpolated from neighboring days rather than read from source. Only present when `interpolated=true` was requested.
      - `extrapolated` boolean, nullable: True if this data point was extrapolated beyond the available source range.
    - `likes` object[]: Time series of cumulative like counts (Facebook, TikTok).
      - `value` number, float, nullable: Metric value at this data point.
      - `timestp` string, date-time, nullable: ISO timestamp at which this data point was recorded.
      - `flags` boolean, nullable: True if a post was made on `source` on this date (e.g. a Facebook post). Helpful for explaining spikes in nearby metrics.
      - `diff` number, float, nullable: Difference between this data point and the previous one in the array. Always null for the first point.
      - `weekly_diff` number, float, nullable: Difference between `value` today and 7 days ago.
      - `weekly_diff_percent` number, float, nullable: Percentage change in `value` over the past 7 days (e.g. `1.39` means +1.39%).
      - `monthly_diff` number, float, nullable: Difference between `value` today and 28 days ago.
      - `monthly_diff_percent` number, float, nullable: Percentage change in `value` over the past 28 days (e.g. `1.39` means +1.39%).
      - `daily_diff` number, float, nullable: Day-over-day difference in `value`. Populated only when `interpolated=true`; when `interpolated=false` the value is returned in `diff` instead. Not applicable for Spotify popularity.
      - `interpolated` boolean, nullable: True if this data point was interpolated from neighboring days rather than read from source. Only present when `interpolated=true` was requested.
      - `extrapolated` boolean, nullable: True if this data point was extrapolated beyond the available source range.
    - `talks` object[]: Time series of "people talking about this" counts (Facebook).
      - `value` number, float, nullable: Metric value at this data point.
      - `timestp` string, date-time, nullable: ISO timestamp at which this data point was recorded.
      - `flags` boolean, nullable: True if a post was made on `source` on this date (e.g. a Facebook post). Helpful for explaining spikes in nearby metrics.
      - `diff` number, float, nullable: Difference between this data point and the previous one in the array. Always null for the first point.
      - `weekly_diff` number, float, nullable: Difference between `value` today and 7 days ago.
      - `weekly_diff_percent` number, float, nullable: Percentage change in `value` over the past 7 days (e.g. `1.39` means +1.39%).
      - `monthly_diff` number, float, nullable: Difference between `value` today and 28 days ago.
      - `monthly_diff_percent` number, float, nullable: Percentage change in `value` over the past 28 days (e.g. `1.39` means +1.39%).
      - `daily_diff` number, float, nullable: Day-over-day difference in `value`. Populated only when `interpolated=true`; when `interpolated=false` the value is returned in `diff` instead. Not applicable for Spotify popularity.
      - `interpolated` boolean, nullable: True if this data point was interpolated from neighboring days rather than read from source. Only present when `interpolated=true` was requested.
      - `extrapolated` boolean, nullable: True if this data point was extrapolated beyond the available source range.
    - `subscribers` object[]: Time series of subscriber counts (YouTube).
      - `value` number, float, nullable: Metric value at this data point.
      - `timestp` string, date-time, nullable: ISO timestamp at which this data point was recorded.
      - `flags` boolean, nullable: True if a post was made on `source` on this date (e.g. a Facebook post). Helpful for explaining spikes in nearby metrics.
      - `diff` number, float, nullable: Difference between this data point and the previous one in the array. Always null for the first point.
      - `weekly_diff` number, float, nullable: Difference between `value` today and 7 days ago.
      - `weekly_diff_percent` number, float, nullable: Percentage change in `value` over the past 7 days (e.g. `1.39` means +1.39%).
      - `monthly_diff` number, float, nullable: Difference between `value` today and 28 days ago.
      - `monthly_diff_percent` number, float, nullable: Percentage change in `value` over the past 28 days (e.g. `1.39` means +1.39%).
      - `daily_diff` number, float, nullable: Day-over-day difference in `value`. Populated only when `interpolated=true`; when `interpolated=false` the value is returned in `diff` instead. Not applicable for Spotify popularity.
      - `interpolated` boolean, nullable: True if this data point was interpolated from neighboring days rather than read from source. Only present when `interpolated=true` was requested.
      - `extrapolated` boolean, nullable: True if this data point was extrapolated beyond the available source range.
    - `views` object[]: Time series of cumulative view counts (YouTube).
      - `value` number, float, nullable: Metric value at this data point.
      - `timestp` string, date-time, nullable: ISO timestamp at which this data point was recorded.
      - `flags` boolean, nullable: True if a post was made on `source` on this date (e.g. a Facebook post). Helpful for explaining spikes in nearby metrics.
      - `diff` number, float, nullable: Difference between this data point and the previous one in the array. Always null for the first point.
      - `weekly_diff` number, float, nullable: Difference between `value` today and 7 days ago.
      - `weekly_diff_percent` number, float, nullable: Percentage change in `value` over the past 7 days (e.g. `1.39` means +1.39%).
      - `monthly_diff` number, float, nullable: Difference between `value` today and 28 days ago.
      - `monthly_diff_percent` number, float, nullable: Percentage change in `value` over the past 28 days (e.g. `1.39` means +1.39%).
      - `daily_diff` number, float, nullable: Day-over-day difference in `value`. Populated only when `interpolated=true`; when `interpolated=false` the value is returned in `diff` instead. Not applicable for Spotify popularity.
      - `interpolated` boolean, nullable: True if this data point was interpolated from neighboring days rather than read from source. Only present when `interpolated=true` was requested.
      - `extrapolated` boolean, nullable: True if this data point was extrapolated beyond the available source range.
    - `videos` object[]: Time series of cumulative video counts (YouTube).
      - `value` number, float, nullable: Metric value at this data point.
      - `timestp` string, date-time, nullable: ISO timestamp at which this data point was recorded.
      - `flags` boolean, nullable: True if a post was made on `source` on this date (e.g. a Facebook post). Helpful for explaining spikes in nearby metrics.
      - `diff` number, float, nullable: Difference between this data point and the previous one in the array. Always null for the first point.
      - `weekly_diff` number, float, nullable: Difference between `value` today and 7 days ago.
      - `weekly_diff_percent` number, float, nullable: Percentage change in `value` over the past 7 days (e.g. `1.39` means +1.39%).
      - `monthly_diff` number, float, nullable: Difference between `value` today and 28 days ago.
      - `monthly_diff_percent` number, float, nullable: Percentage change in `value` over the past 28 days (e.g. `1.39` means +1.39%).
      - `daily_diff` number, float, nullable: Day-over-day difference in `value`. Populated only when `interpolated=true`; when `interpolated=false` the value is returned in `diff` instead. Not applicable for Spotify popularity.
      - `interpolated` boolean, nullable: True if this data point was interpolated from neighboring days rather than read from source. Only present when `interpolated=true` was requested.
      - `extrapolated` boolean, nullable: True if this data point was extrapolated beyond the available source range.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)