Docs menu

Twitch API endpoint

Twitch streams API

Returns the top currently-live streams for a Twitch game/category, ranked by viewer count: title, viewer count, broadcaster, and tags.

GETapiKey2 credits/requestTwitchtwitch.streamsResponseDoc/twitch/streams

Endpoint facts

Method: GET
API path: /twitch/streams
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Twitch
Response schema: #/definitions/twitch.streamsResponseDoc

Twitch scraping API Try Twitch streams API in Playground Twitch API documentation

How this endpoint behaves

Query parameters:

game (required) — a Twitch game/category slug, the lowercase URL slug from twitch.tv/directory/category/{slug} (e.g. league-of-legends).
limit (optional) — number of streams to return. Defaults to 20, clamped to a maximum of 100.

Notable response behavior:

streams is ordered by viewers_count descending — Twitch's own default directory sort.
tags are the stream's freeform tags (language, event, etc.) as Twitch itself surfaces them, not a curated taxonomy.
An unknown game/category slug returns 404. A missing game returns 400 before any upstream request is made.

Live monitoring

Monitored request: GET /twitch/streams?game=league-of-legends&limit=20
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.41 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /twitch/streams?game=league-of-legends&limit=20
Items in streams: 20
Fields filled in every checked item: 6

Field	Filled in, of 20 checked	Values in the sample
id	20
title	20
viewers_count	20	1,514 to 14,250, median 3,382
preview_image_url	20	static-cdn.jtvnw.net
broadcaster	20
tags	20	median 2 entries

Request parameters

Parameter	Type	Required	Description	Example
game	string	Yes	Twitch game/category slug (the lowercase URL slug from twitch.tv/directory/category/{slug})	league-of-legends
limit	integer	No	Number of streams to return (default 20, max 100)	20
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/twitch/streams?game=league-of-legends&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "game": "league-of-legends",
    "count": 20,
    "streams": [
      {
        "id": "317457454434",
        "title": "LCK T1 VS DK - T1 HOMEGROUND",
        "viewers_count": 59142,
        "preview_image_url": "https://static-cdn.jtvnw.net/previews-ttv/live_user_caedrel-640x360.jpg",
        "broadcaster": {
          "id": "92038375",
          "login": "caedrel",
          "display_name": "Caedrel",
          "is_partner": true
        },
        "tags": [
          "English",
          "LCK",
          "Worlds",
          "Esports"
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/twitch.streamsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	twitch.StreamsResponse	No
data.count	integer	No	20
data.game	string	No
data.streams	array	No
data.streams[].broadcaster	twitch.StreamBroadcaster	No
data.streams[].broadcaster.display_name	string	No
data.streams[].broadcaster.id	string	No
data.streams[].broadcaster.is_partner	boolean	No	true
data.streams[].broadcaster.login	string	No
data.streams[].id	string	No
data.streams[].preview_image_url	string	No
data.streams[].tags	array	No
data.streams[].title	string	No
data.streams[].viewers_count	integer	No	56596
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/twitch/streams?game=league-of-legends&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Twitch endpoint docs Twitch scraping API Twitch channel API documentation Twitch clips API documentation Twitch schedule API documentation Twitch search API documentation Twitch team API documentation Twitch top games API documentation

Open in Playground Back to group

Docs menu

Twitch API endpoint

Twitch streams API

Returns the top currently-live streams for a Twitch game/category, ranked by viewer count: title, viewer count, broadcaster, and tags.

GETapiKey2 credits/requestTwitchtwitch.streamsResponseDoc/twitch/streams

Endpoint facts

Method: GET
API path: /twitch/streams
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Twitch
Response schema: #/definitions/twitch.streamsResponseDoc

Twitch scraping API Try Twitch streams API in Playground Twitch API documentation

How this endpoint behaves

Query parameters:

game (required) — a Twitch game/category slug, the lowercase URL slug from twitch.tv/directory/category/{slug} (e.g. league-of-legends).
limit (optional) — number of streams to return. Defaults to 20, clamped to a maximum of 100.

Notable response behavior:

streams is ordered by viewers_count descending — Twitch's own default directory sort.
tags are the stream's freeform tags (language, event, etc.) as Twitch itself surfaces them, not a curated taxonomy.
An unknown game/category slug returns 404. A missing game returns 400 before any upstream request is made.

Live monitoring

Monitored request: GET /twitch/streams?game=league-of-legends&limit=20
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.41 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /twitch/streams?game=league-of-legends&limit=20
Items in streams: 20
Fields filled in every checked item: 6

Field	Filled in, of 20 checked	Values in the sample
id	20
title	20
viewers_count	20	1,514 to 14,250, median 3,382
preview_image_url	20	static-cdn.jtvnw.net
broadcaster	20
tags	20	median 2 entries

Request parameters

Parameter	Type	Required	Description	Example
game	string	Yes	Twitch game/category slug (the lowercase URL slug from twitch.tv/directory/category/{slug})	league-of-legends
limit	integer	No	Number of streams to return (default 20, max 100)	20
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/twitch/streams?game=league-of-legends&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "game": "league-of-legends",
    "count": 20,
    "streams": [
      {
        "id": "317457454434",
        "title": "LCK T1 VS DK - T1 HOMEGROUND",
        "viewers_count": 59142,
        "preview_image_url": "https://static-cdn.jtvnw.net/previews-ttv/live_user_caedrel-640x360.jpg",
        "broadcaster": {
          "id": "92038375",
          "login": "caedrel",
          "display_name": "Caedrel",
          "is_partner": true
        },
        "tags": [
          "English",
          "LCK",
          "Worlds",
          "Esports"
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/twitch.streamsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	twitch.StreamsResponse	No
data.count	integer	No	20
data.game	string	No
data.streams	array	No
data.streams[].broadcaster	twitch.StreamBroadcaster	No
data.streams[].broadcaster.display_name	string	No
data.streams[].broadcaster.id	string	No
data.streams[].broadcaster.is_partner	boolean	No	true
data.streams[].broadcaster.login	string	No
data.streams[].id	string	No
data.streams[].preview_image_url	string	No
data.streams[].tags	array	No
data.streams[].title	string	No
data.streams[].viewers_count	integer	No	56596
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/twitch/streams?game=league-of-legends&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Twitch streams API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Twitch streams API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related