# 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) |
| `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/twitch/user/videos" \
  --data-urlencode "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?