# Social Fetch API - Twitch endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

4 documented Twitch operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/twitch/profiles/{handle}
Get Twitch profile
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/twitch/profiles/handle/get.mdx
SDK: client.twitch.getProfile({ handle: "ishowspeed" })
Parameters:
- handle (required, string) - Twitch handle to look up, with or without a leading @.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/twitch/profiles/ishowspeed" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/twitch/profiles/{handle}/videos
List Twitch profile videos
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/twitch/profiles/handle/videos/get.mdx
SDK: client.twitch.listProfileVideos({ handle: "loltyler1", sortBy: "views" })
Parameters:
- handle (required, string) - Twitch handle to look up, with or without a leading @.
- filterBy (optional, string, enum: highlight | archive | upload) - Optional filter for video type.
- sortBy (optional, string, enum: time | views) - Optional sort order.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/twitch/profiles/ishowspeed/videos?sortBy=time" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/twitch/profiles/{handle}/schedule
Get Twitch profile schedule
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/twitch/profiles/handle/schedule/get.mdx
SDK: client.twitch.getProfileSchedule({ handle: "emongg" })
Parameters:
- handle (required, string) - Twitch handle to look up, with or without a leading @.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/twitch/profiles/ishowspeed/schedule" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/twitch/clips
Get Twitch clip
Credit cost: 1 credit per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/twitch/clips/get.mdx
SDK: client.twitch.getClip({ url: "https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ" })
Parameters:
- url (required, string) - Link to the Twitch clip.
Outcome field: `data.lookupStatus` in `found`, `not_found`
curl "https://api.socialfetch.dev/v1/twitch/clips?url=https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ" \
  -H "x-api-key: YOUR_API_KEY"