{"openapi":"3.1.0","info":{"title":"SHOWROOM Live Streaming API","version":"1.0.0","description":"Live data from SHOWROOM (showroom-live.com), the Japanese live-streaming platform built around idols and talent, read keyless from its public web API. SHOWROOM is where AKB48, Nogizaka46 and thousands of aspiring idols, voice actors and creators broadcast and where fans send virtual gifts in real time — a streaming culture quite unlike Twitch or Kick. This exposes who is live right now, how many are watching, which genres are hot and each room's standing. The live endpoint lists the rooms broadcasting right now across every genre, ranked by viewers, each with its streamer name, current viewer count, genre and how long it has been live (the \"Popularity\" overlay is de-duplicated so every room is counted once under its real category). The genres endpoint aggregates the live picture by category — idols, talents, virtual streamers, music and more — with each genre's number of live rooms and total viewers, so you can see where the audience is. The room endpoint returns one room's profile by its room id: the room name, its follower count, its room level (SHOWROOM's standing metric) and whether it is live now. This is the SHOWROOM platform cut — a distinct social/streaming platform, separate from the Twitch, Kick, Bilibili, Niconico and other feeds in the catalogue. Viewer and follower counts are live; nothing is stored beyond a short cache. Counts are integers; times are UTC.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/showroom-api","description":"oanor gateway"}],"tags":[{"name":"Live"},{"name":"Genres"},{"name":"Room"},{"name":"Meta"},{"name":"Rooms"}],"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":"Rooms live right now, ranked by viewers","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max rooms (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The SHOWROOM rooms broadcasting right now across every genre, ranked by current viewers — each with its streamer name, viewer count, genre and how long it has been live. total_live_rooms and total_viewers are the platform-wide live picture. Pass limit (1-100, default 25). Live, cached ~45s.","count":25,"rooms":[{"name":"坂本 真凛（SKE48 チームS）","genre":"Idol","live_id":23030755,"room_id":76503,"viewers":5197,"room_url":"https://www.showroom-live.com/48_MARIN_SAKAMOTO","started_at":"2026-06-13T04:00:13.000Z","live_minutes":43},{"name":"〜17日ｶﾞﾁｲﾍﾞ中🐼音羽瑞歩(カグヤ新選組)","genre":"Idol","live_id":23030528,"room_id":531895,"viewers":4698,"room_url":"https://www.showroom-live.com/6011d9068886","started_at":"2026-06-13T02:02:56.000Z","live_minutes":160},{"name":"15日～楽曲提供☆I NOUうた☺︎💓☆","genre":"Music","live_id":23030670,"room_id":75721,"viewers":3588,"room_url":"https://www.showroom-live.com/mayachacha","started_at":"2026-06-13T03:10:00.000Z","live_minutes":93},{"name":"清水 紗良（STU48 2期生）","genre":"Idol","live_id":23030671,"room_id":270165,"viewers":3570,"room_url":"https://www.showroom-live.com/48_SHIMIZU_SARA","started_at":"2026-06-13T03:10:01.000Z","live_minutes":93},{"name":"ピンチ🆘TGC超ガチ🔥柳瀬なぎ🍭🍩","genre":"Idol","live_id":23030689,"room_id":490305,"viewers":3408,"room_url":"https://www.showroom-live.com/AngeReve053","started_at":"2026-06-13T03:20:36.000Z","live_minutes":82},{"name":"鈴木 恋奈（SKE48 チームS）","genre":"Idol","live_id":23030761,"room_id":223054,"viewers":2706,"room_url":"https://www.showroom-live.com/48_KOKONA_SUZUKI","started_at":"2026-06-13T04:00:42.000Z","live_minutes":42},{"name":"倉島 杏実（SKE48 チームS）","genre":"Idol","live_id":23030773,"room_id":76549,"viewers":2354,"room_url":"https://www.showroom-live.com/48_AMI_KURASHIMA","started_at":"2026-06-13T04:02:01.000Z","live_minutes":41},{"name":"SR夏まつり実行委員長🔥こがちゃんのちばります！っちゅー話で","genre":"Comedian","live_id":23030637,"room_id":198346,"viewers":2206,"room_url":"https://www.showroom-live.com/kogachan","started_at":"2026-06-13T03:01:32.000Z","live_minutes":101},{"name":"内田祭莉【ミスマガ2027】ベスト20イベント中","genre":"Talent","live_id":23030785,"room_id":573423,"viewers":2101,"room_url":"https://www.showroom-live.com/mm2027_11Um","started_at":"2026-06-13T04:10:58.000Z","live_minutes":32},{"name":"門脇実優菜","genre":"Music","live_id":23030774,"room_id":462126,"viewers":2044,"room_url":"https://www.showroom-live.com/KADOWAKI_MIYUNA","started_at":"2026-06-13T04:02:04.000Z","live_minutes":41},{"name":"Ryo♥️絶対楽しい毎日にしよう‼️","genre":"Streamer","live_id":23030267,"room_id":336836,"viewers":1811,"room_url":"https://www.showroom-live.com/4685a4034136","started_at":"2026-06-13T00:00:44.000Z","live_minutes":282},{"name":"7月17日は10周年ワンマン🗽🌈Annnnnaの空⛱","genre":"Music","live_id":23030741,"room_id":87911,"viewers":1801,"room_url":"https://www.showroom-live.com/0dac11119159","started_at":"2026-06-13T03:55:10.000Z","live_minutes":48},{"name":"芳賀礼（NMB48）","genre":"Idol","live_id":23030831,"room_id":423889,"viewers":1674,"room_url":"https://www.showroom-live.com/48_REI_HAGA","started_at":"2026-06-13T04:32:27.000Z","live_minutes":10},{"name":"桒原 椿（SKE48 チームS）","genre":"Idol","live_id":23030758,"room_id":538780,"viewers":1616,"room_url":"https://www.showroom-live.com/48_TSUBAKI_KUWAHARA","started_at":"2026-06-13T04:00:21.000Z","live_minutes":42},{"name":"杉本 りいな（SKE48 チームS）","genre":"Idol","live_id":23030759,"room_id":404428,"viewers":1585,"room_url":"https://www.showroom-live.com/48_RIINA_SUGIMOTO","started_at":"2026-06-13T04:00:22.000Z","live_minutes":42},{"name":"【総合力で1位へ🥇】長谷川新奈🐰🥕","genre":"Talent","live_id":23030800,"room_id":307073,"viewers":1534,"room_url":"https://www.showroom-live.com/frecam2020_0217","started_at":"2026-06-13T04:19:42.000Z","live_minutes":23},{"name":"【配信3周年㊗️】ぴーちるるーむ🐈🍡保護猫物語","genre":"Talent","live_id":23030570,"room_id":520053,"viewers":1453,"room_url":"https://www.showroom-live.com/chiru0527","started_at":"2026-06-13T02:32:38.000Z","live_minutes":130},{"name":"辻村葉月 No.034 TIF de Debut 2026","genre":"Newcomer","live_id":23030684,"room_id":570435,"viewers":1445,"room_url":"https://www.showroom-live.com/tif_2026_034","started_at":"2026-06-13T03:15:38.000Z","live_minutes":87},{"name":"【大大大感謝💐】🎤KONOKA/穂木の香🌾","genre":"Music","live_id":23030709,"room_id":216058,"viewers":1210,"room_url":"https://www.showroom-live.com/artist-konoka","started_at":"2026-06-13T03:31:22.000Z","live_minutes":71},{"name":"ガチ🔥絶対1位🔥たあちゃんルーム🧸💚","genre":"Talent","live_id":23030650,"room_id":495191,"viewers":1198,"room_url":"https://www.showroom-live.com/tps_20231120","started_at":"2026-06-13T03:02:22.000Z","live_minutes":100},{"name":"【新人ライバーミッション専用ルーム】コメントカウント🆗🆓","genre":"Idol","live_id":23030510,"room_id":573845,"viewers":1179,"room_url":"https://www.showroom-live.com/0f9f69967266","started_at":"2026-06-13T01:59:58.000Z","live_minutes":163},{"name":"🍎みやの食糧庫🍎春水みやこ","genre":"Virtual","live_id":23030631,"room_id":402899,"viewers":1157,"room_url":"https://www.showroom-live.com/580bd6257771","started_at":"2026-06-13T03:00:49.000Z","live_minutes":102},{"name":"坂下 真心（NMB48）","genre":"Idol","live_id":23030830,"room_id":379235,"viewers":1128,"room_url":"https://www.showroom-live.com/48_MAKO_SAKASHITA","started_at":"2026-06-13T04:31:42.000Z","live_minutes":11},{"name":"STU48 9th Anniversary Concert","genre":"Newcomer","live_id":23030737,"room_id":572600,"viewers":1118,"room_url":"https://www.showroom-live.com/stu48_9th_concert","started_at":"2026-06-13T03:50:28.000Z","live_minutes":52},{"name":"ガチイベ参加中❤️‍🔥しずるーむ️🫧🍓","genre":"Talent","live_id":23030666,"room_id":554345,"viewers":1078,"room_url":"https://www.showroom-live.com/sizuku0710","started_at":"2026-06-13T03:05:31.000Z","live_minutes":97}],"source":"SHOWROOM public web API (showroom-live.com/api/live/onlives), keyless","total_viewers":72788,"total_live_rooms":121},"meta":{"timestamp":"2026-06-13T04:42:49.453Z","request_id":"b092dbd7-3811-4f43-9fd4-9c4f300d4d51"},"status":"ok","message":"Live rooms 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/timetable":{"get":{"operationId":"get_v1_timetable","tags":["Live"],"summary":"Scheduled and currently-running streams","description":"","parameters":[{"name":"order","in":"query","required":false,"description":"asc (default, soonest first) or desc","schema":{"type":"string"},"example":"asc"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"},"example":"30"}],"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/genres":{"get":{"operationId":"get_v1_genres","tags":["Genres"],"summary":"Live audience by genre","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"SHOWROOM's live audience by genre right now — for each category (idols, talents, virtual streamers, music…) the number of rooms live and their total viewers, with the most-watched room, ranked by total viewers. The fastest read on where the SHOWROOM audience is. Live, cached ~45s.","count":18,"genres":[{"genre":"Idol","genre_id":102,"top_room":{"name":"坂本 真凛（SKE48 チームS）","room_id":76503,"viewers":5197},"live_rooms":39,"total_viewers":37575},{"genre":"Music","genre_id":112,"top_room":{"name":"15日～楽曲提供☆I NOUうた☺︎💓☆","room_id":75721,"viewers":3588},"live_rooms":16,"total_viewers":10474},{"genre":"Karaoke","genre_id":703,"top_room":{"name":"Ryo♥️絶対楽しい毎日にしよう‼️","room_id":336836,"viewers":1811},"live_rooms":20,"total_viewers":10226},{"genre":"Talent","genre_id":103,"top_room":{"name":"内田祭莉【ミスマガ2027】ベスト20イベント中","room_id":573423,"viewers":2101},"live_rooms":8,"total_viewers":9366},{"genre":"Streamer","genre_id":200,"top_room":{"name":"Ryo♥️絶対楽しい毎日にしよう‼️","room_id":336836,"viewers":1811},"live_rooms":23,"total_viewers":4747},{"genre":"Newcomer","genre_id":758,"top_room":{"name":"辻村葉月 No.034 TIF de Debut 2026","room_id":570435,"viewers":1445},"live_rooms":12,"total_viewers":4645},{"genre":"Comedian","genre_id":105,"top_room":{"name":"SR夏まつり実行委員長🔥こがちゃんのちばります！っちゅー話で","room_id":198346,"viewers":2206},"live_rooms":7,"total_viewers":4203},{"genre":"New30day","genre_id":764,"top_room":{"name":"内田祭莉【ミスマガ2027】ベスト20イベント中","room_id":573423,"viewers":2101},"live_rooms":6,"total_viewers":4163},{"genre":"New7day","genre_id":763,"top_room":{"name":"【新人ライバーミッション専用ルーム】コメントカウント🆗🆓","room_id":573845,"viewers":1179},"live_rooms":3,"total_viewers":2817},{"genre":"Model","genre_id":108,"top_room":{"name":"㊗️２５日～３周年記念ガチ🔥㊗️なほなん癒しのお部屋🧸🌷🌺","room_id":474739,"viewers":734},"live_rooms":8,"total_viewers":1866},{"genre":"Virtual","genre_id":107,"top_room":{"name":"🍎みやの食糧庫🍎春水みやこ","room_id":402899,"viewers":1157},"live_rooms":3,"total_viewers":1717},{"genre":"MEN'S","genre_id":704,"top_room":{"name":"【本日21:00~番組】トナカイになろうよ！三田航佑🎅","room_id":471291,"viewers":889},"live_rooms":4,"total_viewers":1255},{"genre":"Creator","genre_id":113,"top_room":{"name":"🆘ガチ🔥【次枠12:30】こはる☀️🌻🐇","room_id":571751,"viewers":741},"live_rooms":8,"total_viewers":1027},{"genre":"Voice Actor","genre_id":104,"top_room":{"name":"🌸さくままRoom🌸🐰🍒","room_id":512695,"viewers":389},"live_rooms":5,"total_viewers":874},{"genre":"Actor","genre_id":109,"top_room":{"name":"みよりんroom(井上実世)🍙🎙️🌸","room_id":572762,"viewers":348},"live_rooms":3,"total_viewers":474},{"genre":"Announcer","genre_id":110,"top_room":{"name":"りょうの歌ときどきゲーム稀に料理","room_id":334461,"viewers":465},"live_rooms":1,"total_viewers":465},{"genre":"New1day","genre_id":762,"top_room":{"name":"MYNOGEMUHOSO","room_id":573938,"viewers":171},"live_rooms":2,"total_viewers":283},{"genre":"Game","genre_id":706,"top_room":{"name":"豆腐メンタルgames💣👀","room_id":568229,"viewers":45},"live_rooms":1,"total_viewers":45}],"source":"SHOWROOM public web API (showroom-live.com/api/live/onlives), keyless","total_viewers":72788,"total_live_rooms":121},"meta":{"timestamp":"2026-06-13T04:42:49.536Z","request_id":"e7a24de9-77ee-4532-b8a1-59571cec519b"},"status":"ok","message":"Genres 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/room":{"get":{"operationId":"get_v1_room","tags":["Room"],"summary":"One room's profile by id","description":"","parameters":[{"name":"room_id","in":"query","required":true,"description":"Numeric SHOWROOM room id","schema":{"type":"string"},"example":"61576"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"One SHOWROOM room's profile: its name, follower count, room level (SHOWROOM's standing metric, higher is more established), whether it is live right now and, if so, its current viewers. Live, cached ~45s.","source":"SHOWROOM public web API (showroom-live.com/api/room/profile), keyless","is_live":false,"room_id":61576,"room_url":"https://www.showroom-live.com/48_Seina_Fukuoka","followers":24582,"image_url":"https://static.showroom-live.com/image/room/cover/cf6b8f12524a44ad3ee8684de42e39a379b389d55bba86c397b74a28e8649652_m.png?v=1781096760","room_name":"福岡 聖菜（AKB48）","room_level":819,"description":"おしゃべり好きなのでぜひ気軽にみていってください☺️\r\n\r\n福岡聖菜　Seina Fukuoka\r\n \r\n【ﾆｯｸﾈｰﾑ】せいちゃん\r\n\r\n.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ\r\n\r\n【AKB48プライベートメールサービス】\r\nAKB48の推しメンバーから直接メールが届きます！\r\nhttps://www.akb48.co.jp/mailmagazine\r\n\r\n .*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ\r\n\r\n＜プロフィール＞\r\n【生年月日】\r\n 2000年8月1日\r\n\r\n【出身地】\r\n神奈川県\r\n \r\n.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ　.ﾟ･*.*･ﾟ\r\n\r\n＜SNS＞\r\n【X(Twitter)】\r\nhttps://twitter.com/seina_fuku48\r\n\r\n【In","current_viewers":0},"meta":{"timestamp":"2026-06-13T04:42:49.982Z","request_id":"5dd3c452-3b07-4bb2-9a3f-910d9e76379e"},"status":"ok","message":"Room 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-100, default 25). genres and meta take no parameters. room takes room_id (a numeric SHOWROOM room id, required). Viewer and follower counts are live integers; times are UTC. A short ~45-second cache fronts the upstream.","sample":{"live_rooms":121,"total_viewers":72788},"source":"SHOWROOM public web API (showroom-live.com/api), keyless, live","service":"showroom-api","endpoints":{"GET /v1/live":"Rooms live right now, ranked by viewers (limit).","GET /v1/meta":"This document.","GET /v1/room":"One room's profile by id (room_id=61576).","GET /v1/genres":"Live audience by genre — rooms and viewers per category."},"description":"Live data from SHOWROOM (showroom-live.com), the Japanese live-streaming platform built around idols and talent (AKB48, Nogizaka46 and thousands of aspiring idols, voice actors and creators), from its public web API (no key). The live endpoint lists the rooms broadcasting now, ranked by viewers, with name, viewer count, genre and live duration; genres aggregates the live audience by category; room returns one room's profile by id (name, followers, room level, live status). The SHOWROOM platform cut — a distinct social/streaming platform, separate from the Twitch, Kick, Bilibili, Niconico and other feeds.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-13T04:42:50.078Z","request_id":"70f79174-95b1-4d66-9883-efddeb5f9d2a"},"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":["Rooms"],"summary":"Find rooms by name","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Room/streamer name","schema":{"type":"string"},"example":"AKB"},{"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":1350,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1550,"monthly_call_quota":34000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5100,"monthly_call_quota":168000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":14300,"monthly_call_quota":600000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/showroom-api"}