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.

Path Parameters
  • platform
    Type: string enum
    required

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

    values
    • spotify
    • itunes
    • applemusic
    • deezer
  • id
    Type: integer
    min:  
    0
    max:  
    2147483647
    required

    Chartmetric curator ID.

  • source
    Type: string enum
    required

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

    values
    • spotify
    • facebook
    • twitter
    • youtube_channel
    • instagram
    • tiktok
Query Parameters
  • since
    Type: string Format: 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
    Type: string Format: date-time

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

  • field
    Type: 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
    Type: boolean

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

  • interpolated
    Type: boolean

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

Responses
  • application/json
Request Example for get/api/curator/{platform}/{id}/stat/{source}
curl https://api.chartmetric.com/api/curator/spotify/0/stat/spotify \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "followers": [
      {
        "weekly_diff": null,
        "weekly_diff_percent": null,
        "monthly_diff": null,
        "monthly_diff_percent": null,
        "value": 462391,
        "timestp": "2022-02-06T00:00:00.000Z",
        "flags": false,
        "diff": null
      },
      {
        "weekly_diff": null,
        "weekly_diff_percent": null,
        "monthly_diff": null,
        "monthly_diff_percent": null,
        "value": 464773,
        "timestp": "2022-02-16T00:00:00.000Z",
        "flags": false,
        "diff": 2382
      }
    ]
  }
}

Success