API Reference
Collect Twitch channel, live stream, clips, videos, search, top games, and team data through documented Crawlora API endpoints. 9 endpoints documented below.
curl "https://api.crawlora.net/api/v1/twitch/channel?login=caedrel" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's Twitch endpoints return channel, stream, clip, video, and team data as structured JSON with one API key — no Twitch account or OAuth required. A pull on 2026-10-27 showed Just Chatting leading the top games with 199,701 viewers, and a search for minecraft returning 4 typed results for a limit of 5.
Pass a channel login to /twitch/channel for profile, partner status, team, and current live status.
Pass a game/category slug to /twitch/streams for the top live streams, ranked by viewer count.
Use /twitch/clips and /twitch/videos for a channel's clips and past-broadcast videos.
Use /twitch/search for mixed category/channel matches, or /twitch/top-games for the site-wide top games directory.
Pass a team slug to /twitch/team for the full member roster with live status and viewer counts.
top-games returned 10 categories, with Just Chatting (id 509658, tag IRL) first at 199,701 viewers. Counts change by the minute, so store the retrieval time.
search for minecraft with limit 5 returned 4 rows, each typed (the first was a category named Minecraft with its own id and box art). Branch on the type field because channels and categories have different shapes.
/twitch/channelapiKey1 credit/requestReturns a Twitch channel's profile (partner status, team, last broadcast title) plus its current live status (started time and game/category, when live).
Required: login.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: profile_image_url: static-cdn.jtvnw.net; is_partner: true; is_live: false.
/twitch/clipsapiKey2 credits/requestReturns a Twitch channel's clips (last 7 days), most-viewed first: title, view count, duration, curator, and the game it was recorded under.
Required: login. Optional: limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, url, title, view_count, duration_seconds, created_at, thumbnail_url, game and 1 more. In the sample: created_at: 2026-10-07 to 2026-10-13; view_count: 78 to 22,768, median 267; url: twitch.tv; duration_seconds: 5 to 60, median 27; thumbnail_url: static-cdn.jtvnw.net.
/twitch/scheduleapiKey1 credit/requestReturns a Twitch channel's upcoming broadcast schedule -- planned segments with title, start/end time, and game/category -- starting today. A channel with no schedule configured returns an empty segments list, not an error.
Required: channel. Optional: weeks.
Sampled 14 Oct 2026: 6 items. Filled in every item: id, title, start_at, end_at, is_cancelled, categories. In the sample: start_at: 2026-10-12 to 2026-10-18; is_cancelled: true in 0 of 6; categories: median 1 entry; end_at: 2026-10-12 to 2026-10-18.
/twitch/searchapiKey2 credits/requestReturns mixed category and channel matches for a query -- live channels include current viewer count and stream title. Sourced from Twitch's own search-typeahead surface (a capped suggestion list, not a fully paginated results page).
Required: query. Optional: limit.
Sampled 14 Oct 2026: 7 items. Filled in every item: type, text. Not in every item: category (1), channel (6).
/twitch/streamsapiKey2 credits/requestReturns the top currently-live streams for a Twitch game/category, ranked by viewer count: title, viewer count, broadcaster, and tags.
Required: game. Optional: limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, title, viewers_count, preview_image_url, broadcaster, tags. In the sample: viewers_count: 1,514 to 14,250, median 3,382; preview_image_url: static-cdn.jtvnw.net; tags: median 2 entries.
/twitch/teamapiKey2 credits/requestReturns a Twitch team's full member roster, with live status and viewer count for whoever is currently live, plus team-level metadata (banner, logo, description, owner).
Required: team.
Sampled 14 Oct 2026: 5 items. Filled in every item: id, login, display_name, profile_image_url, is_live. Not in every item: viewers_count (1). In the sample: profile_image_url: static-cdn.jtvnw.net; is_live: true in 1 of 5.
/twitch/top-gamesapiKey1 credit/requestReturns the top games/categories site-wide, ranked by total current viewers across all live streams under each one.
Optional: limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, slug, name, box_art_url, viewers_count. Not in every item: tags (19). In the sample: viewers_count: 34,669 to 434,008, median 57,564; box_art_url: static-cdn.jtvnw.net; tags: median 4 entries.
/twitch/videosapiKey2 credits/requestReturns a Twitch channel's past-broadcast videos (VODs), ranked by view count: title, view count, length, publish date, and the game it was recorded under.
Required: login. Optional: limit.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, title, view_count, length_seconds, published_at, thumbnail_url, game, owner. In the sample: published_at: 2020-08-30 to 2023-02-05; view_count: 1,105,395 to 2,800,828, median 1,342,526; thumbnail_url: static-cdn.jtvnw.net; length_seconds: 17,804 to 30,149, median 22,583.
/twitch/vod-commentsapiKey2 credits/requestReturns one page of a Twitch VOD's chat replay (past-broadcast chat messages), starting at a given point in the video's timeline. Paginate forward by re-requesting with the last returned comment's offset_seconds.
Required: video. Optional: offset.
Sampled 14 Oct 2026: 57 items. Filled in every item: id, commenter, offset_seconds, created_at, message, fragments. Not in every item: user_color (48), badges (42). In the sample: created_at: 2026-08-14; fragments: median 1 entry; badges: median 1 entry.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get a Twitch channel's profile and live status | GET /twitch/channel?login=caedrel | 99.4% | 1.30 s |
| Get a Twitch channel's clips | GET /twitch/clips?limit=20&login=caedrel | 100% | 1.42 s |
| Get a Twitch channel's broadcast schedule | GET /twitch/schedule?channel=caedrel&weeks=2 | 99.5% | 1.47 s |
| Search Twitch channels and games/categories | GET /twitch/search?limit=10&query=valorant | 100% | 1.32 s |
| Get the top live streams for a Twitch game/category | GET /twitch/streams?game=league-of-legends&limit=20 | 100% | 1.41 s |
| Get a Twitch team's roster | GET /twitch/team?team=yumetalent | 100% | 2.36 s |
| Get Twitch's top games/categories | GET /twitch/top-games?limit=20 | 100% | 1.30 s |
| Get a Twitch channel's videos (VODs) | GET /twitch/videos?limit=20&login=lck | 99.6% | 1.42 s |
| Get a Twitch VOD's chat replay | GET /twitch/vod-comments?video=2845804307 | 99.8% | 1.47 s |