Skip to content
GET /v1/categories

Top live broadcasts 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/soop-api

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

Get an API key

Code snippets

curl "https://api.oanor.com/soop-api/v1/categories" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/soop-api/v1/categories", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/soop-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/soop-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 SOOP right now — for each game or genre among the top live broadcasts, the number of those broadcasts and their combined viewers, with the leading channel, ranked by viewers. Based on the top live broadcasts by viewers (where the audience concentrates), not every one of the platform's live channels. Live, cached ~45s.",
        "count": 21,
        "source": "SOOP public web API (live.sooplive.co.kr), keyless",
        "categories": [
            {
                "top_bj": {
                    "bj_nick": "팡이요",
                    "viewers": 4314
                },
                "viewers": 6326,
                "category": "메이플스토리",
                "live_broadcasts": 3
            },
            {
                "top_bj": {
                    "bj_nick": "마이곰이",
                    "viewers": 1659
                },
                "viewers": 5597,
                "category": "버추얼",
                "live_broadcasts": 11
            },
            {
                "top_bj": {
                    "bj_nick": "이지상:)",
                    "viewers": 3490
                },
                "viewers": 5200,
                "category": "여행",
                "live_broadcasts": 6
            },
            {
                "top_bj": {
                    "bj_nick": "박진우[JINU]",
                    "viewers": 969
                },
                "viewers": 4270,
                "category": "토크/캠방",
                "live_broadcasts": 12
            },
            {
                "top_bj": {
                    "bj_nick": "A-염보성!!",
                    "viewers": 2079
                },
                "viewers": 3483,
                "category": "리그 오브 레전드",
                "live_broadcasts": 4
            },
            {
                "top_bj": {
                    "bj_nick": ":설영욱",
                    "viewers": 835
                },
                "viewers": 2231,
                "category": "스타크래프트",
                "live_broadcasts": 5
            },
            {
                "top_bj": {
                    "bj_nick": "챈나",
                    "viewers": 1926
                },
                "viewers": 2064,
                "category": "보이스",
                "live_broadcasts": 2
            },
            {
                "top_bj": {
                    "bj_nick": "찬해",
                    "viewers": 1644
                },
                "viewers": 1644,
                "category": "메이플스토리 월드",
                "live_broadcasts": 1
            },
            {
                "top_bj": {
                    "bj_nick": "그릴래영",
                    "viewers": 1189
                },
                "viewers": 1189,
                "category": "취미",
                "live_broadcasts": 1
            },
            {
                "top_bj": {
                    "bj_nick": "나나문",
                    "viewers": 747
                },
                "vie
…