> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/twitch>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/twitch.mdx>

---

# Twitch scraper API. Know when they go live.

Live status, channel cards, VODs, schedules and clips as JSON in one request. No Twitch client ID and no OAuth.

- No client ID
- Live status, VODs and clips

Sponsorship and agency workflows need live state, VOD lists, schedules, and clip metadata — often beside YouTube and TikTok rows. Social Fetch exposes Twitch as GET routes with `{ data, meta }`, `data.lookupStatus`, `meta.requestId`, and `meta.creditsCharged`. Same API key as the rest of the catalog.

## What you can get

- Profile cards by login — bio, avatar, partner flag, followers, social links.
- Live signals on the profile card (`isLive`, current viewer count when available).
- Channel VOD / video lists for recent broadcast history.
- Public stream schedule for upcoming slot planning.
- Clip lookup by public URL — title, views, duration, broadcaster, playable qualities.

## Twitch endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile | GET /v1/twitch/profiles/{handle} | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/twitch/profiles/handle/get) |
| Videos | GET /v1/twitch/profiles/{handle}/videos | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/twitch/profiles/handle/videos/get) |
| Schedule | GET /v1/twitch/profiles/{handle}/schedule | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/twitch/profiles/handle/schedule/get) |
| Clip | GET /v1/twitch/clips | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/twitch/clips/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits — enough to exercise profile, videos, schedule, and a clip URL against live data.
2. **Call a Twitch route.** Start with `GET /v1/twitch/profiles/{handle}` (login with or without `@`). Add `/videos` or `/schedule` for lists and calendar data, or `GET /v1/twitch/clips?url=…` for a share link. Pass `x-api-key`.
3. **Read the shared envelope.** Branch on `data.lookupStatus` before writing rows. Log `meta.requestId` for support. Bill against `meta.creditsCharged` — that field is the source of truth for what the call cost.

## Pricing

Twitch routes charge credits per completed lookup. Profile, videos, schedule, and clip operations document costs in the API reference (typically 1 credit on success for these paths). Credits never expire on pay-as-you-go packs. Check `meta.creditsCharged` on every response.

## Compared with the official API

Twitch Helix and EventSub are for registered apps — chat bots, overlays, realtime subscriptions. Social Fetch is public enrichment: login or clip URL in, JSON out, no Twitch client ID or creator OAuth.

## FAQ

### Is there a Twitch scraper API that works without a Twitch client ID?

Yes. Social Fetch Twitch routes read public channel and clip data. You authenticate to Social Fetch with an API key (`x-api-key`). You do not register a Twitch application or OAuth as the streamer whose public data you are fetching.

### What Twitch data does Social Fetch cover?

Public profiles by login (including live signals and follower metrics), channel video / VOD lists, public stream schedules, and clip metadata by public URL. Exact paths live under `/docs/api` and on this hub's endpoint list.

### How do I get a Twitch profile by handle via API?

Call `GET /v1/twitch/profiles/{handle}` with your Social Fetch key. Pass the channel login with or without a leading `@`. Read `data.lookupStatus`, then `data.profile` and `data.metrics` when the channel is available.

### Can I tell if a Twitch channel is live?

The profile route returns live-oriented fields on the public card when Twitch exposes them (for example `isLive` and current viewer count). Use that for enrichment and roster checks. For low-latency go-live webhooks, use Twitch EventSub directly.

### How do I list a channel's VODs?

Use `GET /v1/twitch/profiles/{handle}/videos`. Paginate with the cursors documented on the operation page until the list is exhausted or your job hits its limit. Call the profile route first when you need an explicit `lookupStatus` before interpreting an empty list.

### Can I fetch a Twitch stream schedule via API?

Yes. `GET /v1/twitch/profiles/{handle}/schedule` returns the public schedule when Twitch exposes one for that channel. Missing or empty schedules still come back in the shared envelope — branch on lookup status and the schedule payload rather than inventing slots.

### How do I resolve a Twitch clip URL?

Pass the public clip link to `GET /v1/twitch/clips` as the `url` query param. On `found`, `data.clip` can include title, view count, duration, broadcaster and curator refs, and playable quality URLs when available.

### Twitch Helix vs Social Fetch — which should I use?

Use Helix and EventSub for Twitch-native apps, bots, chat, and realtime subscriptions. Use Social Fetch when Twitch is one public enrichment source among many (YouTube, TikTok, Instagram) and you want the same credit-metered envelope without a Twitch client ID.

### How much does the Twitch API cost on Social Fetch?

You buy credit packs (or use the 100 free signup credits). Per-route costs are listed in the API reference; check `meta.creditsCharged` after each call. There is no required monthly subscription for pay-as-you-go packs.

### Is scraping Twitch data legal?

Social Fetch returns publicly visible data. You are responsible for how you use it under Twitch's terms, applicable law, and your own compliance review. We do not give legal advice.

## Related

- [Free Twitch earnings calculator](https://www.socialfetch.dev/tools/twitch-earnings-calculator): Estimate directional streamer earnings bands from public Twitch profile and VOD signals.
- [Creator intelligence use case](https://www.socialfetch.dev/use-cases/creator-intelligence-api): Multi-platform streamer and creator enrichment patterns.
- [Influencer data use case](https://www.socialfetch.dev/use-cases/influencer-data-api): Roster cards and campaign baselines across networks.
- [YouTube platform hub](https://www.socialfetch.dev/platforms/youtube): Pair Twitch VODs with YouTube channel and Shorts lookups.