# Twitch User Schedule API (https://www.socialcrawl.dev/platforms/twitch/user-schedule)

> Returns the upcoming stream schedule for a Twitch user — each entry includes start time, end time, title, description, and thumbnail URL.

TL;DR: `GET /v1/twitch/user/schedule` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | Twitch username. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/twitch/user/schedule?handle=kaicenat" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Twitch streamer's schedule?

Send GET /v1/twitch/user/schedule?handle=<username> with your API key. SocialCrawl returns that streamer's published stream schedule, so you can show or track when a channel plans to go live without scraping Twitch yourself.

### What parameters does the schedule endpoint accept?

handle is the only input, the streamer's Twitch username. The endpoint resolves that channel and returns its schedule segments in one call, with no OAuth token or developer app to set up.

### How much does a Twitch schedule call cost?

Each call is 1 credit, the standard tier. New accounts get 100 free credits with no credit card, so you can build a stream-reminder or calendar feature and test it before paying.

### What is in the schedule response?

Each segment carries its start and end time, the stream title, and the category or game planned, so you can render a channel's upcoming calendar or trigger a notification when a new slot appears.

### Can I build go-live reminders with this?

Yes. Poll the schedule on an interval and compare the segment start times against your last run to notify followers about upcoming streams. It pairs well with the Twitch videos endpoint for full-channel coverage.

See the full Twitch API: https://www.socialcrawl.dev/platforms/twitch

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get a Twitch streamer's upcoming stream schedule via API?
- Which API returns when a Twitch channel plans to go live?