---
title: "Get a Twitch channel's profile and live status"
method: GET
path: "/twitch/channel"
tags: ["Twitch"]
---

# Get a Twitch channel's profile and live status

`GET /twitch/channel`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/twitch/channel`
- Auth: API key in header `x-api-key`

Returns a Twitch channel's profile (partner status, team, last broadcast title) plus its current live status (started time and game/category, when live).

## Query parameters

- `login` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TwitchChannelResponseDoc
  - `code` integer
  - `data` TwitchChannelResponse
    - `id` string
    - `is_live` boolean
    - `is_partner` boolean
    - `last_broadcast_title` string
    - `login` string
    - `primary_color_hex` string
    - `primary_team` TwitchChannelTeam
      - `id` string
      - `name` string
    - `profile_image_url` string
    - `stream` TwitchChannelStream
      - `game` TwitchChannelGame
        - `id` string
        - `name` string
        - `slug` string
      - `id` string
      - `started_at` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)