Twitch stream schedule API
A channel's scheduled streams: start and end time, title, categories and whether a stream is cancelled.
GET /v1/twitch/user/schedule
GET /v1/twitch/user/schedule
A channel's scheduled streams: start and end time, title, categories and whether a stream is cancelled.
- Cost: 1 credit
- Cache: Results are kept up to 30 days; send
max_age_daysto reuse them for free. - Timeout: A request still running after about 25 seconds answers
202with a job to poll (Batch and jobs).
Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
handle | string | yes | Username, with or without the leading @. Also accepted as username. |
Every request also accepts:
cursor: the cursor from the previous page (Pagination).trim:truefor a smaller response withoutnullfields andextra.raw:trueto also get the platform's original object asraw.max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).
Example request#
Set your key in the environment first (see Authentication).
1curl -G "https://api.socialscrape.dev/v1/twitch/user/schedule" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "handle=emongg"1import os2import requests34params = {5 "handle": "emongg",6}7res = requests.get(8 "https://api.socialscrape.dev/v1/twitch/user/schedule",9 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},10 params=params,11)12body = res.json()1314if body["ok"]:15 print(body["data"])16else:17 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/twitch/user/schedule");2url.search = new URLSearchParams({3 "handle": "emongg"4}).toString();5const res = await fetch(url, {6 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },7});8const body = await res.json();910if (body.ok) {11 console.log(body.data);12} else {13 console.error(body.error.code, body.error.message);14}1{2 "nodes": [3 {4 "name": "SocialScrape Twitch stream schedule",5 "type": "n8n-nodes-base.httpRequest",6 "typeVersion": 4.2,7 "position": [8 0,9 010 ],11 "parameters": {12 "method": "GET",13 "url": "https://api.socialscrape.dev/v1/twitch/user/schedule",14 "sendQuery": true,15 "queryParameters": {16 "parameters": [17 {18 "name": "handle",19 "value": "emongg"20 }21 ]22 },23 "sendHeaders": true,24 "headerParameters": {25 "parameters": [26 {27 "name": "x-api-key",28 "value": "={{ $env.SOCIALSCRAPE_API_KEY }}"29 }30 ]31 }32 }33 }34 ],35 "connections": {}36}Example response#
This is a sample from a recorded response, lists and long text are shortened. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 1,4 "credits_remaining": 4999,5 "cached": false,6 "cached_at": null,7 "request_id": "req_8ce64d88b98dd33d843403c3",8 "data": {9 "object": "list",10 "items": [11 {12 "object": "event",13 "platform": "twitch",14 "id": "eyJzZWdtZW50SUQiOiI4ZThhMTczMS1hYjU0LTQxZDMtOTEzMy02N2JjZTM0NTRiMzUiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0M30=",15 "url": "https://www.twitch.tv/emongg/schedule",16 "title": null,17 "description": null,18 "starts_at": "2026-10-25T11:00:00Z",19 "ends_at": "2026-10-25T21:00:00Z",20 "place": {21 "name": "Twitch",22 "address": null,23 "city": null,24 "region": null,25 "country": null,26 "latitude": null,27 "longitude": null28 },29 "is_online": true,30 "host": {31 "id": "23220337",32 "handle": "emongg",33 "name": "Emongg",34 "url": "https://www.twitch.tv/emongg",35 "avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/76e05185-d15d-4818-9267-1806b05fa2d1-profile_image-300x300.png",36 "verified": null37 },38 "going_count": null,39 "interested_count": null,40 "cover_url": null,41 "extra": {42 "is_cancelled": false43 }44 },45 {46 "object": "event",47 "platform": "twitch",48 "id": "eyJzZWdtZW50SUQiOiI5NjU1NWMwMC03OGZkLTQ4NTQtYTIyZS1kYWNjOGU3ZWZlYzkiLCJpc29ZZWFyIjoyMDI2LCJpc29XZWVrIjo0NH0=",49 "url": "https://www.twitch.tv/emongg/schedule",50 "title": null,51 "description": null,52 "starts_at": "2026-10-26T11:00:00Z",53 "ends_at": "2026-10-26T21:00:00Z",54 "place": {55 "name": "Twitch",56 "address": null,57 "city": null,58 "region": null,59 "country": null,60 "latitude": null,61 "longitude": null62 },63 "is_online": true,64 "host": {65 "id": "23220337",66 "handle": "emongg",67 "name": "Emongg",68 "url": "https://www.twitch.tv/emongg",69 "avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/76e05185-d15d-4818-9267-1806b05fa2d1-profile_image-300x300.png",70 "verified": null71 },72 "going_count": null,73 "interested_count": null,74 "cover_url": null,75 "extra": {76 "is_cancelled": false77 }78 }79 ],80 "cursor": null,81 "has_more": false,82 "parent": {83 "object": "profile",84 "platform": "twitch",85 "id": "23220337",86 "handle": "emongg",87 "name": "Emongg",88 "headline": null,89 "url": "https://www.twitch.tv/emongg",90 "kind": "channel",91 "bio": null,92 "avatar_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/76e05185-d15d-4818-9267-1806b05fa2d1-profile_image-300x300.png",93 "banner_url": null,94 "verified": null,95 "is_private": null,96 "external_url": null,97 "links": null,98 "location": null,99 "category": null,100 "created_at": null,101 "stats": {102 "followers": null,103 "following": null,104 "posts": null,105 "likes": null,106 "views": null107 },108 "extra": null109 }110 },111 "cursor": null,112 "has_more": false113}Response#
A list of Event objects in data.items, with data.cursor and data.has_more.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
not_found | 404 | no | The platform says this profile, post or item does not exist. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints#
- Twitch channel (
GET /v1/twitch/profile) - Twitch user videos (
GET /v1/twitch/user/videos) - Twitch clip transcript (
GET /v1/twitch/clip/transcript) - Twitch clip (
GET /v1/twitch/clip)