# SocialCrawl API — twitch endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/twitch

## GET /v1/twitch/profile
Get Twitch streamer profile
Credit cost: 1 (standard)
Parameters:
- handle (required) — Twitch username
curl "https://www.socialcrawl.dev/v1/twitch/profile?handle=ninja" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitch/clip
Get Twitch clip details
Credit cost: 1 (standard)
Parameters:
- url (required) — Full URL of the Twitch clip
curl "https://www.socialcrawl.dev/v1/twitch/clip?url=https://www.twitch.tv/ninja/clip/ExampleClipSlug" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitch/user/videos
List a Twitch user's videos
Credit cost: 1 (standard)
Parameters:
- handle (required) — Twitch username.
- filter_by (optional, enum: HIGHLIGHT | UPLOAD) — Filter the returned videos by type — `HIGHLIGHT` or `UPLOAD`. (Archived past broadcasts are not currently available upstream.)
- sort_by (optional, enum: TIME | VIEWS) — Sort order — `TIME` (newest first) or `VIEWS`.
curl "https://www.socialcrawl.dev/v1/twitch/user/videos?handle=ishowspeed" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/twitch/user/schedule
Get a Twitch user's stream schedule
Credit cost: 1 (standard)
Parameters:
- handle (required) — Twitch username.
curl "https://www.socialcrawl.dev/v1/twitch/user/schedule?handle=kaicenat" \
  -H "x-api-key: sc_your_api_key_here"