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

> Fetches up to 100 videos for a Twitch user — id, slug, URL, embed URL, title, view count, language, duration in seconds, game info, broadcaster details with follower count, thumbnail URL, and available video qualities.

TL;DR: `GET /v1/twitch/user/videos` 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. |
| `filter_by` | no | Filter the returned videos by type — `HIGHLIGHT` or `UPLOAD`. (Archived past broadcasts are not currently available upstream.) (HIGHLIGHT \| UPLOAD) |
| `sort_by` | no | Sort order — `TIME` (newest first) or `VIEWS`. (TIME \| VIEWS) |

## Code example

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

## FAQ

### How do I list a Twitch user's videos?

Send GET /v1/twitch/user/videos?handle=<username> with your API key. SocialCrawl returns that channel's videos, including past broadcasts (VODs), highlights, and clips, in one unified list, so you never touch Twitch's OAuth flow.

### What parameters does the Twitch videos endpoint accept?

handle is required. The optional filter_by narrows to a video type such as archive, highlight, or upload, and sort_by orders the results (for example by time or views). Both are passed in the same request.

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

Each call is 1 credit, the standard tier. New accounts get 100 free credits with no credit card, so you can list a channel's full video catalog and prototype before you ever pay.

### Do I need a Twitch developer app or OAuth token?

No. SocialCrawl authenticates every platform with one x-api-key, so you skip registering a Twitch application and managing OAuth tokens. You pass a handle and get back structured video data.

### What is in each video record?

Each item follows SocialCrawl's PostList shape with the video's title, type, duration, view count, and published date, so a Twitch channel parses the same way as a video list from any other platform in your code.

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 channel's videos and VODs from an API?
- Which API lists Twitch clips and highlights without OAuth?