# Twitch

17 endpoints on Twitch. Every one returns the same response shape and has a flat, published price in credits.

Category: [Video & streaming](https://onekey.dev/docs/categories/video.md) · [Overview page](https://onekey.dev/platforms/twitch)

> [!NOTE] **2 of 17 endpoints are marked "needs a pack" or "may need a pack"** in the table: free credits reach only the open fetch path; a verified email and a purchased pack unlock the rest. See [pricing](https://onekey.dev/pricing).

## Endpoints

| Endpoint | What it does | Cost | Status |
| --- | --- | --- | --- |
| [`category`](https://onekey.dev/docs/api/twitch/category.md) | A Twitch category (game): viewers, followers, box art. | 1 credit | stable |
| [`category_streams`](https://onekey.dev/docs/api/twitch/category_streams.md) | Live streams in a Twitch category. | 5 credits | stable |
| [`channel_search`](https://onekey.dev/docs/api/twitch/channel_search.md) | Search Twitch channels by name. | 5 credits | stable |
| [`clip`](https://onekey.dev/docs/api/twitch/clip.md) | A single Twitch clip by slug. | 1 credit | stable |
| [`clips`](https://onekey.dev/docs/api/twitch/clips.md) | Top clips of a Twitch channel (all time). | 5 credits | stable |
| [`live_stream`](https://onekey.dev/docs/api/twitch/live_stream.md) | Current live stream of a Twitch channel (not_found when the channel is offline). | 1 credit | stable |
| [`profile`](https://onekey.dev/docs/api/twitch/profile.md) | Twitch channel profile: display name, bio, followers, avatar, creation date. | 1 credit | stable |
| [`search_categories`](https://onekey.dev/docs/api/twitch/search_categories.md) | Search Twitch categories (games) by name. | 5 credits | stable |
| [`search_channels`](https://onekey.dev/docs/api/twitch/search_channels.md) | Search Twitch channels. | 5 credits | beta |
| [`stream`](https://onekey.dev/docs/api/twitch/stream.md) | Live stream status of a Twitch channel. | 1 credit | beta |
| [`top_categories`](https://onekey.dev/docs/api/twitch/top_categories.md) | Currently most-watched Twitch categories (games). | 5 credits | stable |
| [`top_games`](https://onekey.dev/docs/api/twitch/top_games.md) | Top games on Twitch by viewers. | 5 credits | beta |
| [`top_streams`](https://onekey.dev/docs/api/twitch/top_streams.md) | Currently most-watched live streams on Twitch. | 5 credits | stable |
| [`user`](https://onekey.dev/docs/api/twitch/user.md) | Twitch user by login. | 2 credits | beta **may need a pack** |
| [`user_schedule`](https://onekey.dev/docs/api/twitch/user_schedule.md) | Get a Twitch user's stream schedule. | 2 credits | beta **needs a pack** |
| [`video`](https://onekey.dev/docs/api/twitch/video.md) | A single Twitch video (VOD) by numeric id. | 1 credit | stable |
| [`videos`](https://onekey.dev/docs/api/twitch/videos.md) | Recent videos (VODs) of a Twitch channel. | 1 credit | stable |

Every endpoint page has a **Field mapping** section showing which source field becomes which [unified field](https://onekey.dev/docs/schema.md) (fixed schema) or platform-specific `ext.` field.