# Claude Code skill \[NEW]

Query the StreamsCharts API in plain English — no code, no manual requests.

The skill works with [Claude Code](https://claude.ai/code), Anthropic's AI coding agent that runs locally on your machine. You describe what you want, Claude picks the right endpoint, runs the request, and presents the results as a clean table or dashboard.

{% hint style="info" %}
**Claude Code only.** The skill requires the Claude Code CLI running on your local machine. It will not work in the claude.ai web or mobile chat, where direct HTTP requests to external APIs are restricted.
{% endhint %}

***

## Prerequisites

* [Claude Code](https://claude.ai/code) installed and running
* A StreamsCharts API **Client-ID** and **Token** — get yours at [streamscharts.com/api/token](https://streamscharts.com/api/token)

***

## Installation

{% stepper %}
{% step %}

### Download the skill

[Download streamscharts-api.zip](https://cdn.escharts.com/media/skills/streamscharts-api-0ce195ff2462c60adbe78d4706d6181e.zip)
{% endstep %}

{% step %}

### Unzip and move the folder to your Claude Code skills directory

```bash
unzip streamscharts-api.zip
mv streamscharts-api ~/.claude/skills/
```

The result should look like this:

```
~/.claude/skills/
└── streamscharts-api/
    ├── SKILL.md
    ├── README.md
    └── references/
        └── list-endpoints.md
```

{% hint style="warning" %}
Move the **folder** `streamscharts-api/` into `~/.claude/skills/` — not the zip file itself. Claude Code reads the `SKILL.md` directly from the folder.
{% endhint %}
{% endstep %}

{% step %}

### Restart Claude Code

The skill is loaded automatically. No further configuration needed.
{% endstep %}
{% endstepper %}

***

## Usage

Type `/streamscharts-api` to invoke the skill explicitly, or just ask in plain English — Claude picks it up automatically.

Provide your credentials the first time — Claude will use them for all requests in the session.

```
/streamscharts-api
```

```
Show me xQc's Kick stats for the last 30 days.
My Client-ID is XXXX and Token is YYYY.
```

```
Who are the top 20 Twitch channels by average viewers this month?
```

```
Top 100 female Twitch streamers for April 2026
```

```
Compare shroud and summit1g on Twitch over the last 90 days.
```

Claude automatically selects the correct endpoint, handles authentication, runs the query, and presents the results as a formatted table — including credit usage and remaining balance after every response.

***

## What you can query

| Request type                     | Example                                                       |
| -------------------------------- | ------------------------------------------------------------- |
| Channel stats                    | Average viewers, peak, hours watched, airtime, follower gain  |
| Extended channel stats (Twitch)  | Unique viewers, authorized viewers, stream-level breakdown    |
| Paid subscribers (Twitch)        | Subscriber counts per channel                                 |
| Chat analytics                   | Chat volume, chatters count — Twitch, Kick, YouTube Gaming    |
| Audience geography (Twitch)      | Country breakdown, aggregated over last 30 streams            |
| Audience demographics (Twitch)   | Age, gender breakdown, aggregated over last 30 streams        |
| Stream stats                     | Full metrics for a single broadcast                           |
| Stream viewer watchtime (Twitch) | Per-viewer cumulative watch time for a specific stream        |
| Top channels list                | Filterable by platform, language, country, category, and more |
| Top by subscribers (Twitch)      | Ranked by paid subscriber count                               |
| Top by bits (Twitch)             | Ranked by bits received                                       |

All platforms supported by the StreamsCharts API are available: Twitch, Kick, YouTube Gaming, Rumble, Trovo, NimoTV, Bigo LIVE, Nonolive, AfreecaTV, Mildom, CHZZK, SOOP, and SteamTV.

{% hint style="warning" %}
**YouTube channels** must be identified by channel ID (e.g. `UC1dGHGJTXU_dkiR8tW3qQgg`), not by channel name.
{% endhint %}

***

## Credit costs

Each request consumes credits from your StreamsCharts API balance. After every response, Claude shows exactly how many credits were used and your remaining balance.

| Endpoint                         | First request | Repeat request (within 30 days) |
| -------------------------------- | ------------- | ------------------------------- |
| Channel stats                    | 1 credit      | 0.1–0.3 credits                 |
| Extended channel stats           | 2 credits     | 0.2–0.6 credits                 |
| Chat / subs / geo / demographics | 1 credit      | 0.1–0.3 credits                 |
| Stream stats                     | 1 credit      | 0.2 credits                     |
| Stream viewer watchtime          | 125 credits   | Free (same stream, same day)    |
| Top channels list (per page)     | 20–40 credits | 10–20 credits                   |

Top 100 Twitch channels for the last 7 days is always **free** (0 credits).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://streams-charts.gitbook.io/streams-charts-live-streaming-api-docs/claude-code-skill-new.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.