{"openapi":"3.1.0","info":{"title":"SOOP (AfreecaTV) Live Streaming API","version":"1.0.0","description":"Live data from SOOP (formerly AfreecaTV, sooplive.co.kr), South Korea's biggest live-streaming platform, read keyless from its public web API. SOOP is where Korea's \"BJ\" broadcasters stream games, talk, music and just-chatting to audiences that send star-balloon gifts in real time — the platform that defined Korean streaming culture, much bigger there than Twitch. This exposes who is broadcasting live right now, how many are watching, which categories are hot and each broadcaster's standing. The live endpoint lists the top broadcasts on air right now, ranked by current viewers, each with its BJ (broadcaster) name, title, viewer count, category and how long it has been live. The categories endpoint aggregates the top live broadcasts by category — the games and genres pulling the biggest audiences right now. The station endpoint returns one broadcaster's channel profile by their BJ id: follower count, the all-time views and visits their channel has drawn, when they joined, their total hours broadcast, their partner/best-BJ status and whether they are live now. This is the SOOP platform cut — a distinct social/streaming platform, separate from the Twitch, Kick, SHOWROOM, Bilibili and other feeds in the catalogue. Viewer and follower counts are live; nothing is stored beyond a short cache. Counts are integers; times are reported by the platform (KST).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/soop-api","description":"oanor gateway"}],"tags":[{"name":"Live"},{"name":"Categories"},{"name":"Station"},{"name":"Meta"},{"name":"Broadcasters"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/live":{"get":{"operationId":"get_v1_live","tags":["Live"],"summary":"Top broadcasts live now, ranked by viewers","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max broadcasts (1-60)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The top SOOP broadcasts on air right now, ranked by current viewers — each with its BJ (broadcaster) name, title, viewer count, category and how long it has been live. total_live_broadcasts is the platform-wide count of live channels (this returns the top by viewers). Pass limit (1-60, default 25). Live, cached ~45s.","count":25,"source":"SOOP public web API (live.sooplive.co.kr), keyless","broadcasts":[{"bj_id":"sccha21","title":"팡이요 쇼케이스4시★데몬리마기원  메이플플래닛","bj_nick":"팡이요","started":"2026-06-12 22:30:16","viewers":4314,"category":"메이플스토리","hashtags":["메이플스토리","팡이요","메이플","넥슨커넥트","메이플스토리월드"],"channel_url":"https://play.sooplive.co.kr/sccha21","broadcast_no":294768943,"live_minutes":913,"broadcast_views":5691},{"bj_id":"jrdart","title":"무수네민박 답사 멸망전 [무수]","bj_nick":"이지상:)","started":"2026-06-13 09:57:00","viewers":3490,"category":"여행","hashtags":["노을","이지상"],"channel_url":"https://play.sooplive.co.kr/jrdart","broadcast_no":294775891,"live_minutes":226,"broadcast_views":5623},{"bj_id":"yuambo","title":"YB합숙 마지막날 YB가쏜다","bj_nick":"A-염보성!!","started":"2026-06-10 21:30:58","viewers":2079,"category":"리그 오브 레전드","hashtags":["염보성","yxl","yb"],"channel_url":"https://play.sooplive.co.kr/yuambo","broadcast_no":294716273,"live_minutes":3852,"broadcast_views":3079},{"bj_id":"chaenna02","title":"[하데스] 보이스 2화 안본눈 같이보기","bj_nick":"챈나","started":"2026-06-13 10:59:52","viewers":1926,"category":"보이스","hashtags":["버츄얼","버튜버","하데스"],"channel_url":"https://play.sooplive.co.kr/chaenna02","broadcast_no":294776749,"live_minutes":163,"broadcast_views":3304},{"bj_id":"mygomiee","title":"1시) 하치쿤을 파헤쳐보자 <비하인드> 3화","bj_nick":"마이곰이","started":"2026-06-13 11:58:28","viewers":1659,"category":"버추얼","hashtags":["비타민","동포","증명이","와치동"],"channel_url":"https://play.sooplive.co.kr/mygomiee","broadcast_no":294777545,"live_minutes":104,"broadcast_views":2482},{"bj_id":"chanhaee","title":"찬해 공 17 장갑 성공  24퍼저격 무과금 1100만째중 , 서버 1등 한손검 판매합니다!!  메이플 플래닛","bj_nick":"찬해","started":"2026-06-12 20:42:31","viewers":1644,"category":"메이플스토리 월드","hashtags":["배틀그라운드","찬해","메이플월드"],"channel_url":"https://play.sooplive.co.kr/chanhaee","broadcast_no":294764577,"live_minutes":1020,"broadcast_views":2259},{"bj_id":"xorhkd321","title":"안녕하세요 ( 개못생김 )","bj_nick":"진캐","started":"2026-06-13 13:31:19","viewers":1531,"category":"메이플스토리","hashtags":["진격캐넌","메이플스토리","메이플스토리월드","메이플플래닛"],"channel_url":"https://play.sooplive.co.kr/xorhkd321","broadcast_no":294779183,"live_minutes":11,"broadcast_views":2191},{"bj_id":"eunyoung1238","title":"홈트할래영💪🏻₊·—̳͟͞͞♡","bj_nick":"그릴래영","started":"2026-06-13 11:33:14","viewers":1189,"category":"취미","hashtags":["그릴래영"],"channel_url":"https://play.sooplive.co.kr/eunyoung1238","broadcast_no":294777175,"live_minutes":130,"broadcast_views":1475},{"bj_id":"danchu17","title":"주말이니깐 놀쟈","bj_nick":"단츄♪","started":"2026-06-13 12:01:05","viewers":1138,"category":"버추얼","hashtags":["단코한끼","버컴"],"channel_url":"https://play.sooplive.co.kr/danchu17","broadcast_no":294777619,"live_minutes":102,"broadcast_views":1953},{"bj_id":"pyh3646","title":"페스티벌 40화 대망의 직급전 NEW 스튜디오","bj_nick":"박진우[JINU]","started":"2026-06-13 13:00:02","viewers":969,"category":"토크/캠방","hashtags":["팀진우","보라","엑셀","여행","박진우"],"channel_url":"https://play.sooplive.co.kr/pyh3646","broadcast_no":294778601,"live_minutes":43,"broadcast_views":1831},{"bj_id":"1004suna","title":"임아니 [ 임안이님이 와써  [ yb","bj_nick":"임아니","started":"2026-06-13 11:56:48","viewers":912,"category":"리그 오브 레전드","hashtags":["새해복","마니바드세요","YB"],"channel_url":"https://play.sooplive.co.kr/1004suna","broadcast_no":294777513,"live_minutes":106,"broadcast_views":1437},{"bj_id":"sulstyle00","title":"[신세계:SSG] 안녕하세요 영욱이입니다","bj_nick":":설영욱","started":"2026-06-13 10:26:19","viewers":835,"category":"스타크래프트","hashtags":["설크루","신세계","SSG"],"channel_url":"https://play.sooplive.co.kr/sulstyle00","broadcast_no":294776321,"live_minutes":196,"broadcast_views":1648},{"bj_id":"nanamoon777","title":"야호","bj_nick":"나나문","started":"2026-06-12 19:03:28","viewers":747,"category":"마인크래프트","hashtags":["버츄얼","아카이브","천타버스","섹시"],"channel_url":"https://play.sooplive.co.kr/nanamoon777","broadcast_no":294760647,"live_minutes":1119,"broadcast_views":1084},{"bj_id":"ayanesena","title":"[반캠] 변태 간호사ㅣ시그 시켜주실 오빵이 모집","bj_nick":"아야네_세나","started":"2026-06-13 11:24:16","viewers":719,"category":"여행","hashtags":["버튜버","노래","여캠","종겜","장지수용소"],"channel_url":"https://play.sooplive.co.kr/ayanesena","broadcast_no":294777091,"live_minutes":139,"broadcast_views":879},{"bj_id":"smpk96","title":"주말 낮은 써니~~","bj_nick":"▶박삐삐","started":"2026-06-13 07:45:14","viewers":705,"category":"써니","hashtags":[],"channel_url":"https://play.sooplive.co.kr/smpk96","broadcast_no":294774867,"live_minutes":358,"broadcast_views":1102},{"bj_id":"hwt1014","title":"Green Apple 노래 월드컵 jpop 하나도 모릅니다 !!!","bj_nick":"가습기","started":"2026-06-13 07:00:18","viewers":685,"category":"뮤직/댄스","hashtags":["감스트","포세이돈","감컴","감컴퍼니","가무소"],"channel_url":"https://play.sooplive.co.kr/hwt1014","broadcast_no":294774617,"live_minutes":402,"broadcast_views":1147},{"bj_id":"ititit","title":"수술대) 드릴말씀이 있습니다","bj_nick":"정중만","started":"2026-06-13 13:17:55","viewers":668,"category":"스타크래프트","hashtags":[],"channel_url":"https://play.sooplive.co.kr/ititit","broadcast_no":294778973,"live_minutes":25,"broadcast_views":1401},{"bj_id":"cctvno","title":"시즌3 연창샵 오픈 [버컴]","bj_nick":"유연서","started":"2026-06-12 22:00:32","viewers":548,"category":"버추얼","hashtags":["유연서","버컴","버컴퍼니"],"channel_url":"https://play.sooplive.co.kr/cctvno","broadcast_no":294767835,"live_minutes":942,"broadcast_views":980},{"bj_id":"dbwls991","title":"제부도 힐링(?)용돈 여행 (60/61) 333개 뽀뽀합니다 [수니그룹]","bj_nick":"유진냥","started":"2026-06-13 12:07:51","viewers":509,"category":"토크/캠방","hashtags":["수니그룹","유진냥","남순","신입여캠"],"channel_url":"https://play.sooplive.co.kr/dbwls991","broadcast_no":294777761,"live_minutes":95,"broadcast_views":924},{"bj_id":"skswhdkgo","title":"글자 생방 드디어 오버드라이브 쇼케 날!! 진짜 기대 됩니다!!!!!  .감컴","bj_nick":"세글자♡","started":"2026-06-13 11:15:17","viewers":481,"category":"메이플스토리","hashtags":["세글자","메이플","메이플스토리","넥슨커넥트"],"channel_url":"https://play.sooplive.co.kr/skswhdkgo","broadcast_no":294776987,"live_minutes":148,"broadcast_views":602},{"bj_id":"since821","title":" 음악방송 멜론노래 24시간 발라드명곡차트 가수히트곡인기가요 음방최신가요팝송댄스곡라디오퀵뷰섹시소통신입","bj_nick":"♥심장","started":"2026-05-14 04:27:12","viewers":450,"category":"음악 스트리밍","hashtags":["music","song"],"channel_url":"https://play.sooplive.co.kr/since821","broadcast_no":293993385,"live_minutes":43756,"broadcast_views":807},{"bj_id":"zbxlzzz","title":"[YXL] 소다의 필라테스 ❤️ 첫번째 회원님 오는중 ^-^","bj_nick":"소다♥","started":"2026-06-13 12:14:39","viewers":432,"category":"토크/캠방","hashtags":["YXL","YB","엑셀","염보성","여캠"],"channel_url":"https://play.sooplive.co.kr/zbxlzzz","broadcast_no":294777895,"live_minutes":88,"broadcast_views":466},{"bj_id":"yus1031","title":"일본인 ) 지금 핫한 한국 군산5섬백패킹 도전하겠습습니다!!","bj_nick":"유이뿅♥","started":"2026-06-13 08:34:49","viewers":422,"category":"여행","hashtags":["여행","해외여행","일본","먹방"],"channel_url":"https://play.sooplive.co.kr/yus1031","broadcast_no":294775183,"live_minutes":308,"broadcast_views":738},{"bj_id":"hachi97","title":"🐻 1시 마이곰이님 토크쇼 <비하인드>","bj_nick":"하치_HACHI","started":"2026-06-13 12:30:10","viewers":398,"category":"버추얼","hashtags":["버튜버","버추얼","종합게임","아이작","꼬라지"],"channel_url":"https://play.sooplive.co.kr/hachi97","broadcast_no":294778115,"live_minutes":73,"broadcast_views":539},{"bj_id":"yeeeee00","title":"오늘 웨이터들 죽이겠습니다. [이노레이블:부장]","bj_nick":"애지니♡","started":"2026-06-13 12:02:47","viewers":396,"category":"토크/캠방","hashtags":["이노레이블","김인호","엑셀","여캠","신입"],"channel_url":"https://play.sooplive.co.kr/yeeeee00","broadcast_no":294777665,"live_minutes":100,"broadcast_views":533}],"shown_viewers":28846,"total_live_broadcasts":1641},"meta":{"timestamp":"2026-06-13T04:42:47.200Z","request_id":"cffed5a3-1127-4608-9b6a-89e2279576d9"},"status":"ok","message":"Live broadcasts retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/live-search":{"get":{"operationId":"get_v1_live_search","tags":["Live"],"summary":"Find live broadcasts on air by keyword","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Keyword (game/topic/title)","schema":{"type":"string"},"example":"lol"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/categories":{"get":{"operationId":"get_v1_categories","tags":["Categories"],"summary":"Top live broadcasts aggregated by category","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},"viewers":1128,"category":"마인크래프트","live_broadcasts":2},{"top_bj":{"bj_nick":"▶박삐삐","viewers":705},"viewers":1041,"category":"써니","live_broadcasts":2},{"top_bj":{"bj_nick":"가습기","viewers":685},"viewers":685,"category":"뮤직/댄스","live_broadcasts":1},{"top_bj":{"bj_nick":"♥심장","viewers":450},"viewers":450,"category":"음악 스트리밍","live_broadcasts":1},{"top_bj":{"bj_nick":"배구중립2","viewers":310},"viewers":386,"category":"국내프로배구","live_broadcasts":2},{"top_bj":{"bj_nick":"양팡♥","viewers":367},"viewers":367,"category":"먹방/쿡방","live_broadcasts":1},{"top_bj":{"bj_nick":"손유진","viewers":327},"viewers":327,"category":"서든어택","live_broadcasts":1},{"top_bj":{"bj_nick":"여우연","viewers":239},"viewers":239,"category":"승리의 여신: 니케","live_broadcasts":1},{"top_bj":{"bj_nick":"[V]원재","viewers":223},"viewers":223,"category":"리니지 클래식","live_broadcasts":1},{"top_bj":{"bj_nick":"나솜","viewers":188},"viewers":188,"category":"종합게임","live_broadcasts":1},{"top_bj":{"bj_nick":"방배우","viewers":169},"viewers":169,"category":"FC 온라인","live_broadcasts":1},{"top_bj":{"bj_nick":"욱하는형","viewers":131},"viewers":131,"category":"토크/분석","live_broadcasts":1}],"based_on_top_broadcasts":60},"meta":{"timestamp":"2026-06-13T04:42:47.285Z","request_id":"86e55a06-e130-4b69-9b53-e0aa110283c9"},"status":"ok","message":"Categories retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/station":{"get":{"operationId":"get_v1_station","tags":["Station"],"summary":"One broadcaster's channel profile by bj_id","description":"","parameters":[{"name":"bj_id","in":"query","required":true,"description":"SOOP broadcaster id","schema":{"type":"string"},"example":"phonics1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"One SOOP broadcaster's channel: their follower count, the all-time views and visits the channel has drawn, when they joined, their total hours broadcast and their partner/best-BJ status — plus, if they are live now, their current viewer count and how long they have been on. Live, cached ~45s.","bj_id":"sccha21","joined":"2010-10-04 11:29:49","source":"SOOP public web API (chapi.sooplive.co.kr/api/{bj}/station), keyless","is_live":true,"followers":522531,"is_best_bj":true,"channel_url":"https://play.sooplive.co.kr/sccha21","total_views":454574956,"total_visits":17887479,"is_partner_bj":true,"profile_image":"//profile.img.sooplive.co.kr/LOGO/sc/sccha21/sccha21.jpg","station_title":"메이플스토리 스카니아 방송","total_broadcast_hours":60084},"meta":{"timestamp":"2026-06-13T04:42:48.480Z","request_id":"840391d3-e369-453b-8c06-5b8a64f34264"},"status":"ok","message":"Station retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"live takes limit (1-60, default 25). categories and meta take no parameters. station takes bj_id (a SOOP broadcaster id, required). Viewer and follower counts are live integers; timestamps are KST as reported, durations computed in minutes/hours. A short ~45-second cache fronts the upstream.","sample":{"top_bj":"팡이요","viewers":4314,"total_live_broadcasts":1641},"source":"SOOP public web API (sooplive.co.kr), keyless, live","service":"soop-api","endpoints":{"GET /v1/live":"Top broadcasts live now, ranked by viewers (limit).","GET /v1/meta":"This document.","GET /v1/station":"One broadcaster's channel profile by bj_id (bj_id=sccha21).","GET /v1/categories":"Top live broadcasts aggregated by category."},"description":"Live data from SOOP (formerly AfreecaTV), South Korea's biggest live-streaming platform, from its public web API (no key). The live endpoint lists the top broadcasts on air now ranked by viewers (BJ name, title, viewers, category, live duration); categories aggregates the top live broadcasts by game/genre; station returns one broadcaster's channel profile by BJ id (followers, all-time views/visits, join date, total broadcast hours, partner/best-BJ status, live status). The SOOP platform cut — a distinct social/streaming platform, separate from the Twitch, Kick, SHOWROOM, Bilibili and other feeds.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-13T04:42:48.559Z","request_id":"b957d7e0-2f2b-4526-b583-8c6eecf1aa29"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Broadcasters"],"summary":"Find broadcasters (BJs) by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Broadcaster name","schema":{"type":"string"},"example":"lol"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1250,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1650,"monthly_call_quota":31000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5400,"monthly_call_quota":172000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":14900,"monthly_call_quota":590000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/soop-api"}