# CHZZK Live Streaming API > Live data from CHZZK (chzzk.naver.com), the Korean live-streaming platform built and run by Naver, Korea's dominant web portal. CHZZK rose fast after Twitch withdrew from Korea and is now one of the country's two big streaming platforms alongside SOOP — gamers, just-chatting, sports and esports broadcasters streaming to large Korean audiences. The live endpoint lists the streams on air right now ranked by current viewers, each with its channel name, title, concurrent viewer count, this broadcast's accumulated viewers, category and how long it has been live. The categories endpoint aggregates the top live streams by category (the games and genres pulling the biggest audiences right now). The channel endpoint returns one channel's profile by its 32-character channel id: follower count, verified status, description and whether it is live now. The search endpoint finds CHZZK channels by keyword, each with follower count and live status. This is the CHZZK platform cut — a distinct social/streaming platform, separate from the SOOP, SHOWROOM, Niconico, Twitch, Kick, Bilibili and other feeds in the catalogue. Viewer and follower counts are live integers; broadcast start times are KST as the platform reports them. Keyless public source, nothing stored beyond a short cache. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/chzzk-api/..." ``` ## Pricing - **Free** (Free) — 650 calls/Mo, 2 req/s - **Starter** ($33/Mo) — 75,000 calls/Mo, 6 req/s - **Pro** ($88/Mo) — 520,000 calls/Mo, 16 req/s - **Scale** ($239/Mo) — 3,100,000 calls/Mo, 40 req/s ## Endpoints ### Live #### `GET /v1/live` — Top streams live now, ranked by viewers **Parameters:** - `limit` (query, optional, string) — Max streams (1-50) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/chzzk-api/v1/live?limit=25" ``` **Response:** ```json { "data": { "note": "The top CHZZK streams on air right now, ranked by current viewers — each with its channel name, title, viewer count (concurrent, live), accumulated viewers for this broadcast, category and how long it has been live. Pass limit (1-50, default 25). Live, cached ~45s.", "count": 25, "source": "CHZZK public web API (api.chzzk.naver.com/service/v1/lives), keyless", "streams": [ { "adult": false, "title": "(광고) 월드컵엔 프리스타일 풋볼2", "live_id": 19418887, "viewers": 11237, "category": "종합 게임", "verified": true, "open_date": "2026-06-13 12:07:34", "channel_id": "75cbf189b3bb8f9f687d2aca0d0a382b", "channel_url": "https://chzzk.naver.com/75cbf189b3bb8f9f687d2aca0d0a382b", "channel_name": "한동숙", "live_minutes": 95, "category_type": "GAME", "accumulated_viewers": 0 }, { "adult": false, "title": "1시 해축입문 강의 w. 블레어로즈 ⚽", "live_id": 19418873, "viewers": 5190, "category": "talk", "verified": true, "open_date": "2026-06-13 12:06:45", "channel_id": "eaf7b569c9992d0e57db0059eb5c0eeb", "channel_url …(truncated, see openapi.json for full schema) ``` ### Categories #### `GET /v1/categories` — Top live streams aggregated by category **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/chzzk-api/v1/categories" ``` **Response:** ```json { "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" }, { …(truncated, see openapi.json for full schema) ``` ### Channel #### `GET /v1/channel` — One channel's profile by channel id **Parameters:** - `channel_id` (query, required, string) — 32-char hex channel id Example: `9381e7d6816e6d915a44a13c0195b202` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/chzzk-api/v1/channel?channel_id=9381e7d6816e6d915a44a13c0195b202" ``` **Response:** ```json { "data": { "note": "One CHZZK channel's profile: its follower count, verified status, description and whether it is broadcasting live right now. Live, cached ~45s.", "source": "CHZZK public web API (api.chzzk.naver.com/service/v1/channels), keyless", "is_live": false, "verified": true, "followers": 136272, "image_url": "https://nng-phinf.pstatic.net/MjAyNjA2MDVfMjgx/MDAxNzgwNjM2MTU2OTkx.-w0g1n-oQ7Qzy-fmHiKQ5G3gtStEulzdyQPTJewsgTEg.wqahNtKPgt4GuzyB62ZkLmPxK2qUkb7BSMtjCf3oIOwg.PNG/image.png", "channel_id": "8ecd602c251f30fd7f09463e9f55609f", "channel_url": "https://chzzk.naver.com/8ecd602c251f30fd7f09463e9f55609f", "description": null, "channel_name": "북중미 월드컵 JTBC" }, "meta": { "timestamp": "2026-06-13T04:42:45.779Z", "request_id": "948d0ae8-3041-48de-b736-32c1a323dd01" }, "status": "ok", "message": "Channel retrieved successfully", "success": true } ``` ### Search #### `GET /v1/search` — Search channels by keyword **Parameters:** - `q` (query, required, string) — Search keyword Example: `lck` - `limit` (query, optional, string) — Max results (1-50) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/chzzk-api/v1/search?q=lck&limit=20" ``` **Response:** ```json { "data": { "note": "CHZZK channels matching a keyword — each with its follower count, verified status and whether it is live right now. Pass q (required) and limit (1-50, default 20). Live, cached ~45s.", "count": 20, "query": "game", "source": "CHZZK public web API (api.chzzk.naver.com/service/v1/search/channels), keyless", "channels": [ { "is_live": true, "verified": false, "followers": 6645, "channel_id": "e12f8c8ed9925b297a496431929bcdb1", "channel_url": "https://chzzk.naver.com/e12f8c8ed9925b297a496431929bcdb1", "description": "항상 즐겁게 게임하고 싶은 게이머비누입니다 :)", "channel_name": "게이머비누Gamerbinu" }, { "is_live": false, "verified": true, "followers": 1464, "channel_id": "d88f036f2d5a83c7580884acdc14eaa5", "channel_url": "https://chzzk.naver.com/d88f036f2d5a83c7580884acdc14eaa5", "description": "Summer Game Fest - Streaming Live on Friday, June 6 ", "channel_name": "The Game Awards" }, { "is_live": false, "verified": false, "followers": 847, "channel_id": "aa596ceebc1580cd1147c19bf1b2ebe1", "channel_url": "https://chzzk.naver.com/ …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/chzzk-api/v1/meta" ``` **Response:** ```json { "data": { "note": "live takes limit (1-50, default 25). categories and meta take no parameters. channel takes channel_id (a 32-char hex CHZZK channel id, required). search takes q (required) and limit. Viewer counts are concurrent (live) integers; accumulated_viewers is this broadcast's cumulative total; follower counts are live. Broadcast start times are KST as reported; durations computed in minutes. A short ~45-second cache fronts the upstream.", "sample": { "viewers": 11237, "category": "종합 게임", "top_channel": "한동숙" }, "source": "CHZZK public web API (api.chzzk.naver.com/service/v1), keyless, live", "service": "chzzk-api", "endpoints": { "GET /v1/live": "Top streams live now, ranked by viewers (limit).", "GET /v1/meta": "This document.", "GET /v1/search": "Search channels by keyword (q=...).", "GET /v1/channel": "One channel's profile by channel_id.", "GET /v1/categories": "Top live streams aggregated by category." }, "description": "Live data from CHZZK (chzzk.naver.com), the Korean live-streaming platform built and run by Naver that rose after Twitch left Korea and is now one of the country's two big streaming platforms alongside SOOP, from its public web API (no key). The live endpoint lists the streams on air now ranked by viewers (channel, title, viewers, category, live duration); categorie …(truncated, see openapi.json for full schema) ``` ### Channels #### `GET /v1/videos` — A channel's videos (VODs and replays), newest first **Parameters:** - `channel_id` (query, required, string) — 32-char hex channel id Example: `9381e7d6816e6d915a44a13c0195b202` - `limit` (query, optional, string) — Max videos (1-50) Example: `20` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/chzzk-api/v1/videos?channel_id=9381e7d6816e6d915a44a13c0195b202&limit=20" ``` --- Marketplace page: https://www.oanor.com/api/chzzk-api OpenAPI spec: https://www.oanor.com/api/chzzk-api/openapi.json