Skip to content
GET /v1/categories

Top live streams aggregated by category

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/chzzk-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/chzzk-api/v1/categories" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/chzzk-api/v1/categories", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/chzzk-api/v1/categories");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/chzzk-api/v1/categories",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "The categories pulling the biggest audiences on CHZZK right now — for each game or genre among the top live streams, the number of those streams and their combined current viewers, with the leading channel, ranked by viewers. Based on the top live streams by viewers (where the audience concentrates), not every live channel on the platform. Live, cached ~45s.",
        "count": 23,
        "source": "CHZZK public web API (api.chzzk.naver.com/service/v1/lives), keyless",
        "categories": [
            {
                "viewers": 14339,
                "category": "talk",
                "top_channel": {
                    "viewers": 5190,
                    "channel_name": "이글콥"
                },
                "live_streams": 10,
                "category_type": "ETC"
            },
            {
                "viewers": 12439,
                "category": "종합 게임",
                "top_channel": {
                    "viewers": 11237,
                    "channel_name": "한동숙"
                },
                "live_streams": 2,
                "category_type": "GAME"
            },
            {
                "viewers": 10166,
                "category": "메이플스토리",
                "top_channel": {
                    "viewers": 4874,
                    "channel_name": "삼식"
                },
                "live_streams": 4,
                "category_type": "GAME"
            },
            {
                "viewers": 9066,
                "category": "명조:워더링 웨이브",
                "top_channel": {
                    "viewers": 4608,
                    "channel_name": "시라유키 히나"
                },
                "live_streams": 5,
                "category_type": "GAME"
            },
            {
                "viewers": 5894,
                "category": "FC온라인",
                "top_channel": {
                    "viewers": 2543,
                    "channel_name": "허니츄러스"
                },
                "live_streams": 3,
                "category_type": "GAME"
            },
            {
                "viewers": 5537,
                "category": "부두 피싱",
                "top_channel": {
                    "viewers": 3266,
                    "channel_name": "김뚜띠"
                },
                "live_streams": 2,
                "category_type": "GAME"
            },
            {
                "viewers": 3140,
                "category": "리그 오브 레전드",
                "top_channel": {
                    "viewers": 1552,
                    "channel_name": "고수달"
                },
                "live_streams": 3,
                "category_type": "GAME"
            },
            {
                "viewers": 2239,
                "category": "이터널 리턴",
                "top_channel": {
                    "viewers": 845,
                    "channel_name": "이터널 리턴 공식"
                },
                "live_streams": 4,
                "category_type": "GAME"
            },
     
…