# FREE request

{% hint style="info" %}
The TOP 100 Twitch channels for the past seven days are for free, we will not charge credits for that.
{% endhint %}

#### How to access the free request of the top 100 Twitch channels for the last 7 days

You will need a Client ID and a token to use Streams Charts API. Your Client ID is bound to your account and can never be changed, but you can change your access token anytime for security reasons.

```
curl -X GET https://streamscharts.com/api/jazz/channels?platform=twitch&time=7-days \
-H 'Client-ID: XXXXXXXXXXXX' \
-H 'Token: YYYYYYYYYYYYYY'
```

*Use your Client ID and token instead of "XXXXXXXXXXXX" and "YYYYYYYYYYYYYY", which you can find* [*here*](https://streamscharts.com/api/token)*.*

The response you would get would be a JSON response that contains something like a sample response:

```json
{
"data": [
{
"platform": "twitch",
"channel_name": "xqc",
"channel_display_name": "xQc",
"channel_id": "71092938",
"hours_watched": 4094054,
"peak_viewers": 105095,
"average_viewers": 63148,
"airtime_in_m": 3890,
"followers_gain": 30419,
"live_views": "12977101",
"last_streamed_game": "Grand Theft Auto V",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/xqc-profile_image-9298dca608632101-300x300.jpeg",
"channel_country": "CA",
"stream_language": "en",
"partnership_status": "partner",
"channel_type": "male"
},
{
"platform": "twitch",
"channel_name": "loud_coringa",
"channel_display_name": "loud_coringa",
"channel_id": "569325723",
"hours_watched": 2672997,
"peak_viewers": 110919,
"average_viewers": 68539,
"airtime_in_m": 2340,
"followers_gain": 36547,
"live_views": "11252398",
"last_streamed_game": "Grand Theft Auto V",
"avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/c07acddc-1e1b-479f-97c4-09636f80e857-profile_image-300x300.png",
"channel_country": "BR",
"stream_language": "pt",
"partnership_status": "partner",
"channel_type": "male"
},
...
],
"links": {
"first": "http://streamscharts.com/api/jazz/channels?platform=twitch&time=7-days&page=1",
"last": null,
"prev": null,
"next": "http://streamscharts.com/api/jazz/channels?platform=twitch&time=7-days&page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"path": "http://streamscharts.com/api/jazz/channels",
"per_page": 100,
"to": 100
},
"filters": {
"platform": "twitch",
"time": "7-days"
}
}
```


---

# 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/free-request.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.