Twitch User Charts

​

Twitch user charts by duration (daily/weekly/monthly) and type (followers or view counts). Handler builds the source twitch_*_chart table dynamically, then merges platform-linked artist info and historical rankStats from QUERY_GET_USER_RANKINGS.TWITCH.

Query Parameters
  • date
    Type: string Format: date-time

    Charting date (YYYY-MM-DD); defaults to the latest available chart.

  • since
    Type: string Format: date-time

    Lower bound of the date range (YYYY-MM-DD). Required unless latest=true.

  • limit
    Type: integer

    Maximum entries returned (max 500).

  • duration
    Type: string enum
    required

    Chart duration. daily requires type=followers; monthly requires type=viewer_hours.

    values
    • daily
    • weekly
    • monthly
  • type

    Twitch chart type (followers or viewer_hours). Constrained by duration (see error messages).

    • enum
      const:  
      followers

      Twitch chart type (followers or viewer_hours). Constrained by duration (see error messages).

      values
      • followers
      • enum
        const:  
        viewer_hours
        values
        • viewer_hours
  • latest
    Type: boolean

    If true, use the most recently available date and ignore since.

Responses
  • application/json
Request Example for get/api/charts/twitch/users
curl 'https://api.chartmetric.com/api/charts/twitch/users?duration=daily' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": null,
    "data": [
      {
        "rank": null,
        "pre_rank": null,
        "peak_rank": null,
        "peak_date": "2026-07-20T17:45:03.313Z",
        "added_at": "2026-07-20T17:45:03.313Z",
        "velocity": null,
        "time_on_chart": "string",
        "twitch_user": 0,
        "followers": 1,
        "weekly_followers": 1,
        "monthly_followers": 1,
        "count": 1,
        "weekly_count": 1,
        "monthly_count": 1,
        "name": null,
        "image_url": null,
        "link": null,
        "cm_artist": null,
        "rankStats": [
          {
            "rank": null,
            "followers": 1,
            "timestp": "2026-07-20T17:45:03.313Z"
          }
        ]
      }
    ]
  }
}

Success