# Twitch API Reference Canonical: https://monsterapi.co/docs/api/twitch Read the Twitch API reference. Review parameters, response fields, examples, and current credit prices. OpenAPI specification: [Twitch](https://monsterapi.co/docs/openapi/platforms/twitch.yaml). --- Current operation prices: [public catalog](https://monsterapi.co/account/api/v1/public/api-prices). Prices use credits per request. --- # Twitch: Global chat badges `GET /twitch/api/badges` Documentation: https://monsterapi.co/docs/api/twitch#global-chat-badges Operation ID: `twitch_global_badges` Returns the badges every channel of the site shares, with their images. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs ## Responses - 200: Global badges - 400: Refusal envelope Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: all primary lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/badges' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel profile `GET /twitch/api/channel/{login}` Documentation: https://monsterapi.co/docs/api/twitch#channel-profile Operation ID: `twitch_channel_profile` Returns the profile of one channel by its account name, together with the broadcast it is airing. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Channel profile - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Sponsored-content flag `GET /twitch/api/channel/{login}/branded` Documentation: https://monsterapi.co/docs/api/twitch#sponsored-content-flag Operation ID: `twitch_channel_branded` Reports whether the channel declares the broadcast it is airing as sponsored. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Sponsorship flag - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/branded' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Charity campaign `GET /twitch/api/channel/{login}/charity` Documentation: https://monsterapi.co/docs/api/twitch#charity-campaign Operation ID: `twitch_channel_charity` Returns the identifier of one channel’s active charity campaign. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Fundraiser state - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/charity' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Chat room settings `GET /twitch/api/channel/{login}/chatroom` Documentation: https://monsterapi.co/docs/api/twitch#chat-room-settings Operation ID: `twitch_chat_room` Returns a channel’s chat settings, rules, badges and identifiers of pinned messages. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Chat room settings - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/chatroom' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Cheer emotes `GET /twitch/api/channel/{login}/cheermotes` Documentation: https://monsterapi.co/docs/api/twitch#cheer-emotes Operation ID: `twitch_channel_cheermotes` Returns the cheer emotes of one channel and the ones every channel shares, with their bit thresholds. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Cheer emotes - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or all primary lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/cheermotes' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel clips `GET /twitch/api/channel/{login}/clips` Documentation: https://monsterapi.co/docs/api/twitch#channel-clips Operation ID: `twitch_channel_clips` Returns the most watched clips of one channel within the chosen window. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). - `period` (query, optional): Clip ranking window. Defaults to the last week. - `limit` (query, optional): Entries to ask for, between 1 and 100. Defaults to the largest page. - `cursor` (query, optional): Optional continuation cursor from `next_cursor` in the preceding response to GET /twitch/api/channel/{login}/clips or GET /twitch/api/game/{name}/clips. Keep the same endpoint, channel or category, and filters. [Channel clips](https://monsterapi.co/docs/api/twitch-clip#channel-clips), [Clips of a category](https://monsterapi.co/docs/api/twitch-clip#clips-of-a-category). ## Responses - 200: Page of clips - 400: bad_request: invalid path or query parameter, including a malformed continuation cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/clips' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel video shelves `GET /twitch/api/channel/{login}/collections` Documentation: https://monsterapi.co/docs/api/twitch#channel-video-shelves Operation ID: `twitch_channel_collections` Returns one page of a channel's video shelves: broadcasts, clips, highlights and collections. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). - `cursor` (query, optional): Optional continuation cursor from `next_cursor` in the preceding response to GET /twitch/api/channel/{login}/collections or GET /twitch/api/collection/{id}. Keep the same endpoint and channel or collection. [Channel shelves](https://monsterapi.co/docs/api/twitch-video#channel-video-shelves), [Collection videos](https://monsterapi.co/docs/api/twitch-video#collection-videos). ## Responses - 200: Shelves of the channel - 400: bad_request: invalid path or query parameter, including a malformed continuation cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/collections' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel emotes `GET /twitch/api/channel/{login}/emotes` Documentation: https://monsterapi.co/docs/api/twitch#channel-emotes Operation ID: `twitch_channel_emotes` Returns the emotes a channel grants, split by the subscription tier or the cheering that unlocks them. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Emotes of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or all primary lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/emotes' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel goals `GET /twitch/api/channel/{login}/goals` Documentation: https://monsterapi.co/docs/api/twitch#channel-goals Operation ID: `twitch_channel_goals` Returns a channel’s goals, including their contribution type, state, current value and target. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Goals of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or all primary lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/goals' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel leaderboards `GET /twitch/api/channel/{login}/leaderboard` Documentation: https://monsterapi.co/docs/api/twitch#channel-leaderboards Operation ID: `twitch_channel_leaderboard` Returns the bits, gifted subscription and clip leaderboards of one channel for the period Twitch selects. Disabled tables are null. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Leaderboards of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/leaderboard' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Moderator roster `GET /twitch/api/channel/{login}/mods` Documentation: https://monsterapi.co/docs/api/twitch#moderator-roster Operation ID: `twitch_channel_moderators` Returns one page of moderators when Twitch discloses it. A roster withheld from guests returns requires_auth (501). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). - `cursor` (query, optional): Continuation from `next_cursor` in the preceding response of the same GET path; omit for the first page. Use [GET /twitch/api/channel/{login}/mods](https://monsterapi.co/docs/api/twitch-channel#moderator-roster), [GET /twitch/api/channel/{login}/vips](https://monsterapi.co/docs/api/twitch-channel#vip-roster) or [GET /twitch/api/team/{name}](https://monsterapi.co/docs/api/twitch-channel#twitch-team); keep the same channel or team. ## Responses - 200: Moderator roster - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/mods' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel info panels `GET /twitch/api/channel/{login}/panels` Documentation: https://monsterapi.co/docs/api/twitch#channel-info-panels Operation ID: `twitch_channel_panels` Returns the information panels a channel shows under its player. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Information panels - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or the requested list is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/panels' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Viewable poll `GET /twitch/api/channel/{login}/poll` Documentation: https://monsterapi.co/docs/api/twitch#viewable-poll Operation ID: `twitch_channel_poll` Returns the poll Twitch currently shows for one channel. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Viewable poll - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/poll' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel predictions `GET /twitch/api/channel/{login}/predictions` Documentation: https://monsterapi.co/docs/api/twitch#channel-predictions Operation ID: `twitch_channel_predictions` Returns the predictions of one channel, split into the ones taking stakes, the locked ones and the resolved ones. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Predictions of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/predictions' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Recommended channels `GET /twitch/api/channel/{login}/recommended` Documentation: https://monsterapi.co/docs/api/twitch#recommended-channels Operation ID: `twitch_channel_recommended` Returns the channels one channel recommends on its page, and the team it belongs to. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Recommended channels - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or the requested list is empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/recommended' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel Points rewards `GET /twitch/api/channel/{login}/rewards` Documentation: https://monsterapi.co/docs/api/twitch#channel-points-rewards Operation ID: `twitch_channel_rewards` Returns custom and automatic reward settings and point costs for one channel. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Rewards of the channel - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/rewards' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Stream schedule `GET /twitch/api/channel/{login}/schedule` Documentation: https://monsterapi.co/docs/api/twitch#stream-schedule Operation ID: `twitch_channel_schedule` Returns the schedule a channel published, with the entry it is airing now and the one it aired last. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Published schedule - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/schedule' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Channel recordings `GET /twitch/api/channel/{login}/videos` Documentation: https://monsterapi.co/docs/api/twitch#channel-recordings Operation ID: `twitch_channel_videos` Returns the recordings of one channel, narrowed by kind and ordered by time or by views. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). - `type` (query, optional): Kind of broadcast to list. Every kind is listed when the parameter is absent. - `sort` (query, optional): Order of the listing. Defaults to newest first. - `limit` (query, optional): Entries to ask for, between 1 and 100. Defaults to the largest page. - `cursor` (query, optional): Optional continuation cursor from `next_cursor` in the preceding response to GET /twitch/api/channel/{login}/videos; keep the same channel, kind and sort order. [Channel recordings](https://monsterapi.co/docs/api/twitch-video#channel-recordings). ## Responses - 200: Page of recordings - 400: bad_request: invalid path or query parameter, including a malformed continuation cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/videos' \ -H 'Authorization: Bearer ' ``` --- # Twitch: VIP roster `GET /twitch/api/channel/{login}/vips` Documentation: https://monsterapi.co/docs/api/twitch#vip-roster Operation ID: `twitch_channel_vips` Returns one page of VIPs of one channel, with Twitch's continuation cursor when available. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). - `cursor` (query, optional): Continuation from `next_cursor` in the preceding response of the same GET path; omit for the first page. Use [GET /twitch/api/channel/{login}/mods](https://monsterapi.co/docs/api/twitch-channel#moderator-roster), [GET /twitch/api/channel/{login}/vips](https://monsterapi.co/docs/api/twitch-channel#vip-roster) or [GET /twitch/api/team/{name}](https://monsterapi.co/docs/api/twitch-channel#twitch-team); keep the same channel or team. ## Responses - 200: VIP roster - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/channel/{login}/vips' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Clip metadata `GET /twitch/api/clip/{slug}` Documentation: https://monsterapi.co/docs/api/twitch#clip-metadata Operation ID: `twitch_clip_details` Returns one clip by its slug, with its place in the source recording and the files it can be downloaded as. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `slug` (path, required): Clip slug from `clips[].slug` in [GET /twitch/api/channel/{login}/clips](https://monsterapi.co/docs/api/twitch-clip#channel-clips) ## Responses - 200: Clip metadata - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/clip/{slug}' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Related clips `GET /twitch/api/clip/{slug}/related` Documentation: https://monsterapi.co/docs/api/twitch#related-clips Operation ID: `twitch_clip_related` Returns the clips the site recommends beside one clip. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `slug` (path, required): Clip slug from `clips[].slug` in [GET /twitch/api/channel/{login}/clips](https://monsterapi.co/docs/api/twitch-clip#channel-clips) ## Responses - 200: Related clips - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or all primary lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/clip/{slug}/related' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Top clips `GET /twitch/api/clips/top` Documentation: https://monsterapi.co/docs/api/twitch#top-clips Operation ID: `twitch_top_clips` Returns the most watched clips of the whole site, optionally narrowed to one broadcast language. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `language` (query, optional): Broadcast language, as an ISO 639-1 code. Every language is listed when absent. - `limit` (query, optional): Entries to ask for, between 1 and 100. Defaults to the largest page. - `cursor` (query, optional): Optional continuation cursor from `next_cursor` in the preceding response to GET /twitch/api/clips/top; keep the same language filter. [Top clips](https://monsterapi.co/docs/api/twitch-clip#top-clips). ## Responses - 200: Page of clips - 400: bad_request: invalid path or query parameter, including a malformed continuation cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/clips/top' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Collection videos `GET /twitch/api/collection/{id}` Documentation: https://monsterapi.co/docs/api/twitch#collection-videos Operation ID: `twitch_collection_details` Returns collection metadata and one page of recordings. Use `shelves[].collection_id` from [GET /twitch/api/channel/{login}/collections](https://monsterapi.co/docs/api/twitch-video#channel-video-shelves). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Collection identifier from `shelves[].collection_id` in [GET /twitch/api/channel/{login}/collections](https://monsterapi.co/docs/api/twitch-video#channel-video-shelves) - `cursor` (query, optional): Optional continuation cursor from `next_cursor` in the preceding response to GET /twitch/api/channel/{login}/collections or GET /twitch/api/collection/{id}. Keep the same endpoint and channel or collection. [Channel shelves](https://monsterapi.co/docs/api/twitch-video#channel-video-shelves), [Collection videos](https://monsterapi.co/docs/api/twitch-video#collection-videos). ## Responses - 200: Collection and its recordings - 400: bad_request: invalid path or query parameter, including a malformed continuation cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/collection/{id}' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Featured streams `GET /twitch/api/featured` Documentation: https://monsterapi.co/docs/api/twitch#featured-streams Operation ID: `twitch_featured_streams` Returns the broadcasts Twitch promotes on its front page for a language; defaults to English. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `language` (query, optional): Optional language for featured broadcasts as a two-letter ISO 639-1 code. Defaults to `en` (English). ## Responses - 200: Promoted broadcasts - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested result lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/featured' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Category details `GET /twitch/api/game/{name}` Documentation: https://monsterapi.co/docs/api/twitch#category-details Operation ID: `twitch_category_details` Returns one category by its directory slug. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (path, required): Required category slug: 1 to 100 ASCII letters, digits, underscores or hyphens. Use `categories[].slug` from [GET /twitch/api/games](https://monsterapi.co/docs/api/twitch-directory#all-categories) or `categories.items[].slug` from [GET /twitch/api/search](https://monsterapi.co/docs/api/twitch-directory#search-channels-categories-and-recordings). ## Responses - 200: Category details - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/game/{name}' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Clips of a category `GET /twitch/api/game/{name}/clips` Documentation: https://monsterapi.co/docs/api/twitch#clips-of-a-category Operation ID: `twitch_game_clips` Returns the most watched clips of one category within the chosen window. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (path, required): Required category slug: 1 to 100 ASCII letters, digits, underscores or hyphens. Use `categories[].slug` from [GET /twitch/api/games](https://monsterapi.co/docs/api/twitch-directory#all-categories) or `categories.items[].slug` from [GET /twitch/api/search](https://monsterapi.co/docs/api/twitch-directory#search-channels-categories-and-recordings). - `period` (query, optional): Clip ranking window. Defaults to the last week. - `limit` (query, optional): Entries to ask for, between 1 and 100. Defaults to the largest page. - `cursor` (query, optional): Optional continuation cursor from `next_cursor` in the preceding response to GET /twitch/api/channel/{login}/clips or GET /twitch/api/game/{name}/clips. Keep the same endpoint, channel or category, and filters. [Channel clips](https://monsterapi.co/docs/api/twitch-clip#channel-clips), [Clips of a category](https://monsterapi.co/docs/api/twitch-clip#clips-of-a-category). ## Responses - 200: Page of clips - 400: bad_request: invalid path or query parameter, including a malformed continuation cursor Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/game/{name}/clips' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Live streams of a category `GET /twitch/api/game/{name}/streams` Documentation: https://monsterapi.co/docs/api/twitch#live-streams-of-a-category Operation ID: `twitch_game_streams` Returns one page of broadcasts airing in a category, optionally filtered by language. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (path, required): Required category slug: 1 to 100 ASCII letters, digits, underscores or hyphens. Use `categories[].slug` from [GET /twitch/api/games](https://monsterapi.co/docs/api/twitch-directory#all-categories) or `categories.items[].slug` from [GET /twitch/api/search](https://monsterapi.co/docs/api/twitch-directory#search-channels-categories-and-recordings). - `sort` (query, optional): Sort order. Defaults to `viewer_count`, with the most watched first. - `language` (query, optional): Optional broadcast language as a two-letter ISO 639-1 code. Omit to apply no language filter. - `limit` (query, optional): Requested page size, from 1 to 100. Defaults to 100. - `cursor` (query, optional): Use `next_cursor` from the preceding response of [GET /twitch/api/game/{name}/streams](https://monsterapi.co/docs/api/twitch-directory#live-streams-of-a-category). Pass unchanged as `cursor`, keeping the same path and filters; omit for the first page. ## Responses - 200: Page of broadcasts - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/game/{name}/streams' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Recordings of a category `GET /twitch/api/game/{name}/videos` Documentation: https://monsterapi.co/docs/api/twitch#recordings-of-a-category Operation ID: `twitch_game_videos` Returns one page of recordings in a category, ordered by views or time. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (path, required): Required category slug: 1 to 100 ASCII letters, digits, underscores or hyphens. Use `categories[].slug` from [GET /twitch/api/games](https://monsterapi.co/docs/api/twitch-directory#all-categories) or `categories.items[].slug` from [GET /twitch/api/search](https://monsterapi.co/docs/api/twitch-directory#search-channels-categories-and-recordings). - `sort` (query, optional): Sort order. Defaults to `time`, with newest recordings first. - `limit` (query, optional): Requested page size, from 1 to 100. Defaults to 100. - `cursor` (query, optional): Use `next_cursor` from the preceding response of [GET /twitch/api/game/{name}/videos](https://monsterapi.co/docs/api/twitch-directory#recordings-of-a-category). Pass unchanged as `cursor`, keeping the same path and filters; omit for the first page. ## Responses - 200: Page of recordings - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/game/{name}/videos' \ -H 'Authorization: Bearer ' ``` --- # Twitch: All categories `GET /twitch/api/games` Documentation: https://monsterapi.co/docs/api/twitch#all-categories Operation ID: `twitch_categories_list` Returns one page of Twitch categories, ordered by viewers or relevance. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `sort` (query, optional): Sort order. Defaults to `viewer_count`, with the most watched first. - `limit` (query, optional): Requested page size, from 1 to 100. Defaults to 100. - `cursor` (query, optional): Use `next_cursor` from the preceding response of [GET /twitch/api/games](https://monsterapi.co/docs/api/twitch-directory#all-categories). Pass unchanged as `cursor`, keeping the same path and filters; omit for the first page. ## Responses - 200: Page of categories - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/games' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Search channels, categories and recordings `GET /twitch/api/search` Documentation: https://monsterapi.co/docs/api/twitch#search-channels-categories-and-recordings Operation ID: `twitch_search_all` Searches channels, categories and recordings for one term, including related live broadcasts. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Required search text with at least one non-whitespace character. Surrounding spaces are preserved. ## Responses - 200: Matches by kind - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested result lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/search' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Search categories `GET /twitch/api/search/categories` Documentation: https://monsterapi.co/docs/api/twitch#search-categories Operation ID: `twitch_search_categories` Returns one page of categories matching a search term. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Required search text with at least one non-whitespace character. Surrounding spaces are preserved. - `cursor` (query, optional): Use `next_cursor` from the preceding response of [GET /twitch/api/search/categories](https://monsterapi.co/docs/api/twitch-directory#search-categories). Pass unchanged as `cursor`, keeping the same path and filters; omit for the first page. ## Responses - 200: Page of categories - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/search/categories' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Search live streams `GET /twitch/api/search/streams` Documentation: https://monsterapi.co/docs/api/twitch#search-live-streams Operation ID: `twitch_search_streams` Returns live broadcasts matching a search term. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `q` (query, required): Required search text with at least one non-whitespace character. Surrounding spaces are preserved. ## Responses - 200: Matching broadcasts - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested result lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/search/streams' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Live chat snapshot `GET /twitch/api/stream/{login}/chat` Documentation: https://monsterapi.co/docs/api/twitch#live-chat-snapshot Operation ID: `twitch_live_chat_snapshot` Returns chat messages received during the requested window. Returns not_found (404) when the channel is absent or suspended, or no messages are received. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). - `seconds` (query, optional): Snapshot duration in seconds, from 1 to 30. Defaults to 8. - `limit` (query, optional): Maximum messages in the snapshot, from 1 to 1000. Defaults to 200. ## Responses - 200: Messages collected in the window - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: channel absent or suspended, or an empty snapshot with no messages in the requested window - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 503: overloaded: no collection capacity; upstream_error: chat connection failed, including disconnection before joining; retry after Retry-After Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/stream/{login}/chat' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Live HLS manifest `GET /twitch/api/stream/{login}/playback` Documentation: https://monsterapi.co/docs/api/twitch#live-hls-manifest Operation ID: `twitch_stream_playback` Returns a channel’s HLS variants and media tracks. Requires `token` and `sig` from GET /twitch/api/stream/{login}/playback/token; an offline channel is not_found, expired permission is bad_request with message token expired, request a new one. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). - `token` (query, required): Required signed value from the top-level `token` field in GET /twitch/api/video/{id}/playback/token ([Recording token](https://monsterapi.co/docs/api/twitch-video#recording-playback-token)) or GET /twitch/api/stream/{login}/playback/token ([Live token](https://monsterapi.co/docs/api/twitch-video#live-playback-token)). Pass unchanged and URL-encoded for the matching recording or channel, at most 8192 characters. Requires a JSON object with integer expires/version, authorization and chansub objects, and a numeric vod_id or channel string matching the path. - `sig` (query, required): Required signature from the top-level `signature` field in the same GET /twitch/api/video/{id}/playback/token or GET /twitch/api/stream/{login}/playback/token response. [Recording token](https://monsterapi.co/docs/api/twitch-video#recording-playback-token), [Live token](https://monsterapi.co/docs/api/twitch-video#live-playback-token). Pass unchanged and URL-encoded; nonempty, at most 8192 characters, without control characters. ## Responses - 200: HLS variant URIs and string attributes - 400: bad_request: token or signature is malformed or expired, permission does not match the channel, or a required parameter is missing; request a new token when expired Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: private: playback is unavailable to anonymous viewers in this region or requires a subscription Refused at the gateway: the API key is unknown or revoked - 404: not_found: channel is offline or the stream is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/stream/{login}/playback' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Live playback token `GET /twitch/api/stream/{login}/playback/token` Documentation: https://monsterapi.co/docs/api/twitch#live-playback-token Operation ID: `twitch_stream_playback_token` Returns signed playback permission for one channel. Pass `token` and `signature` as `token` and `sig` to GET /twitch/api/stream/{login}/playback; permission does not guarantee a live broadcast. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `login` (path, required): Required account username: 1 to 25 ASCII letters, digits or underscores. Use `users[].username` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Signed stream permission - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/stream/{login}/playback/token' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Popular live streams `GET /twitch/api/streams` Documentation: https://monsterapi.co/docs/api/twitch#popular-live-streams Operation ID: `twitch_popular_streams` Returns one page of broadcasts across Twitch, optionally filtered by language. Allows at most 30 entries per page. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `sort` (query, optional): Sort order. Defaults to `viewer_count`, with the most watched first. - `language` (query, optional): Optional broadcast language as a two-letter ISO 639-1 code. Omit to apply no language filter. - `limit` (query, optional): Requested page size, from 1 to 30. Defaults to 30. - `cursor` (query, optional): Use `next_cursor` from the preceding response of [GET /twitch/api/streams](https://monsterapi.co/docs/api/twitch-directory#popular-live-streams). Pass unchanged as `cursor`, keeping the same path and filters; omit for the first page. ## Responses - 200: Page of broadcasts - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/streams' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Team `GET /twitch/api/team/{name}` Documentation: https://monsterapi.co/docs/api/twitch#twitch-team Operation ID: `twitch_team_details` Returns one Twitch team by its slug and one page of its members, with Twitch's continuation cursor when available. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `name` (path, required): Required team slug: 1 to 100 ASCII letters, digits, underscores or hyphens. Use `team.slug` from [GET /twitch/api/channel/{login}/recommended](https://monsterapi.co/docs/api/twitch-channel#recommended-channels). - `cursor` (query, optional): Continuation from `next_cursor` in the preceding response of the same GET path; omit for the first page. Use [GET /twitch/api/channel/{login}/mods](https://monsterapi.co/docs/api/twitch-channel#moderator-roster), [GET /twitch/api/channel/{login}/vips](https://monsterapi.co/docs/api/twitch-channel#vip-roster) or [GET /twitch/api/team/{name}](https://monsterapi.co/docs/api/twitch-channel#twitch-team); keep the same channel or team. ## Responses - 200: Team and its members - 400: bad_request: a parameter or continuation cursor has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/team/{name}' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Accounts by identifier `GET /twitch/api/users` Documentation: https://monsterapi.co/docs/api/twitch#accounts-by-identifier Operation ID: `twitch_users_by_ids` Returns account profiles for the comma-separated numeric IDs in `ids`. Unknown IDs retain null positions; an all-unknown list returns not_found (404). ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `ids` (query, required): Numeric account identifiers, separated by commas. At most 100 in one call; no empty entries. Surrounding whitespace is ignored for each ID; order and duplicates are preserved. Use non-null `channel.id` from [GET /twitch/api/channel/{login}](https://monsterapi.co/docs/api/twitch-channel#channel-profile) or `users[].id` from [GET /twitch/api/users](https://monsterapi.co/docs/api/twitch-channel#accounts-by-identifier). ## Responses - 200: Resolved accounts - 400: bad_request: a path or query parameter has the wrong format or value Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: empty result because all requested account identifiers are unknown; unknown accounts retain null slots beside known accounts in a 200 response - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited or upstream_error: retry after Retry-After; upstream_stale or no_proxies: service temporarily unavailable; overloaded: capacity temporarily unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/users' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Recording metadata `GET /twitch/api/video/{id}` Documentation: https://monsterapi.co/docs/api/twitch#recording-metadata Operation ID: `twitch_video_details` Returns one recording by its numeric identifier, with its category, owner and content labels. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Numeric recording identifier from `videos[].id` in [GET /twitch/api/channel/{login}/videos](https://monsterapi.co/docs/api/twitch-video#channel-recordings) ## Responses - 200: Recording metadata - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/video/{id}' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Recording chapters `GET /twitch/api/video/{id}/chapters` Documentation: https://monsterapi.co/docs/api/twitch#recording-chapters Operation ID: `twitch_video_chapters` Returns the marked points of one recording, such as every moment its category changed. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Numeric recording identifier from `videos[].id` in [GET /twitch/api/channel/{login}/videos](https://monsterapi.co/docs/api/twitch-video#channel-recordings) ## Responses - 200: Chapters of the recording - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent or all primary lists are empty - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/video/{id}/chapters' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Recorded chat `GET /twitch/api/video/{id}/chat` Documentation: https://monsterapi.co/docs/api/twitch#recorded-chat Operation ID: `twitch_video_chat_replay` Returns a recording's chat window around offset in seconds, possibly including earlier messages. Pass next_cursor unchanged as cursor for sequential continuation; cursor takes precedence over offset. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Numeric recording identifier from `videos[].id` in [GET /twitch/api/channel/{login}/videos](https://monsterapi.co/docs/api/twitch-video#channel-recordings) - `offset` (query, optional): Nonnegative seek position in seconds, up to 2,147,483,647. Defaults to 0. The chat window may include messages before this position. Ignored when a cursor is given; otherwise must be less than the recording length. - `cursor` (query, optional): Optional continuation cursor from `next_cursor` in the preceding response to GET /twitch/api/video/{id}/chat for the same recording; takes precedence over `offset`. [Recorded chat](https://monsterapi.co/docs/api/twitch-video#recorded-chat). ## Responses - 200: Slice of the recorded chat - 400: bad_request: identifier, offset or cursor is malformed, or offset is past the recording length Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: resource absent, or no records and no next_cursor; an empty page with next_cursor returns 200 - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/video/{id}/chat' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Recording HLS manifest `GET /twitch/api/video/{id}/playback` Documentation: https://monsterapi.co/docs/api/twitch#recording-hls-manifest Operation ID: `twitch_video_playback` Returns a recording’s HLS variants and media tracks. Requires `token` and `sig` from GET /twitch/api/video/{id}/playback/token; expired permission returns bad_request with message token expired, request a new one. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Numeric recording identifier from `videos[].id` in [GET /twitch/api/channel/{login}/videos](https://monsterapi.co/docs/api/twitch-video#channel-recordings) - `token` (query, required): Required signed value from the top-level `token` field in GET /twitch/api/video/{id}/playback/token ([Recording token](https://monsterapi.co/docs/api/twitch-video#recording-playback-token)) or GET /twitch/api/stream/{login}/playback/token ([Live token](https://monsterapi.co/docs/api/twitch-video#live-playback-token)). Pass unchanged and URL-encoded for the matching recording or channel, at most 8192 characters. Requires a JSON object with integer expires/version, authorization and chansub objects, and a numeric vod_id or channel string matching the path. - `sig` (query, required): Required signature from the top-level `signature` field in the same GET /twitch/api/video/{id}/playback/token or GET /twitch/api/stream/{login}/playback/token response. [Recording token](https://monsterapi.co/docs/api/twitch-video#recording-playback-token), [Live token](https://monsterapi.co/docs/api/twitch-video#live-playback-token). Pass unchanged and URL-encoded; nonempty, at most 8192 characters, without control characters. ## Responses - 200: HLS variant URIs and string attributes - 400: bad_request: token or signature is malformed or expired, permission does not match the recording, or a required parameter is missing; request a new token when expired Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: private: playback is unavailable to anonymous viewers in this region or requires a subscription Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/video/{id}/playback' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Recording playback token `GET /twitch/api/video/{id}/playback/token` Documentation: https://monsterapi.co/docs/api/twitch#recording-playback-token Operation ID: `twitch_video_playback_token` Returns signed playback permission for one recording. Pass `token` and `signature` as `token` and `sig` to GET /twitch/api/video/{id}/playback. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Numeric recording identifier from `videos[].id` in [GET /twitch/api/channel/{login}/videos](https://monsterapi.co/docs/api/twitch-video#channel-recordings) ## Responses - 200: Signed recording permission - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/video/{id}/playback/token' \ -H 'Authorization: Bearer ' ``` --- # Twitch: Seekbar preview index `GET /twitch/api/video/{id}/storyboard` Documentation: https://monsterapi.co/docs/api/twitch#seekbar-preview-index Operation ID: `twitch_video_storyboard` Returns the address of the seekbar preview index of one recording, which a client fetches itself. ## Authentication Send your billing API key in the `Authorization: Bearer ` header. Your account login is separate. ## Inputs - `id` (path, required): Numeric recording identifier from `videos[].id` in [GET /twitch/api/channel/{login}/videos](https://monsterapi.co/docs/api/twitch-video#channel-recordings) ## Responses - 200: Address of the preview index - 400: bad_request: invalid path or query parameter Refused at the gateway: the request target, path and query string together, is longer than 8,192 bytes; or the headers, the target counted among them, exceed 16,384 bytes or 64 fields - 401: Refusal envelope Refused at the gateway: the `Authorization` header carries no API key, or a malformed one - 402: Refusal envelope Refused at the gateway: the credits of the account do not cover the price of the operation - 403: Refusal envelope Refused at the gateway: the API key is unknown or revoked - 404: not_found: requested resource does not exist or is unavailable - 405: `method_not_allowed`: the endpoint answers GET alone, and any other method, HEAD included, is refused Refused at the gateway: the path exists, but no operation on it takes the method of the request, HEAD included; `Allow` names the methods that do - 409: Refusal envelope Refused at the gateway: a repeat of a request the gateway already checked differs from the original - 429: Refusal envelope Refused at the gateway: the account calls faster than its rate limit allows - 500: upstream_shape: Twitch returned an unreadable or unexpected response; this does not indicate the end of a listing - 501: requires_auth: requested information is unavailable to anonymous viewers - 503: rate_limited: retry after Retry-After; upstream_error: retry after Retry-After; upstream_stale: Twitch access temporarily unavailable; no_proxies: Twitch access temporarily unavailable; overloaded: capacity unavailable Refused at the gateway: the check could not complete, the account is suspended, or the platform did not answer; each may pass later, and `Retry-After` comes only when the platform did not answer - default: Refusal envelope ## Credits Check the live price in the documentation before sending. Platform 2xx and 4xx responses can use credits, including empty data. Gateway refusals and 5xx responses do not use credits. Each pagination request is a separate call. https://monsterapi.co/docs/pricing ## Request template Replace path placeholders and add the required query parameters from the Inputs section before sending. ```shell curl --get 'https://api.monsterapi.co/twitch/api/video/{id}/storyboard' \ -H 'Authorization: Bearer ' ```