getLiveOrUpcomingVideosForSetOfChannels

Method that makes a GET request to https://holodex.net/api/v2/users/live

Returns

A List of Video objects matching the given parameters.

Parameters

Name	Type
getQueryParameters	GetQueryParameters

Allowed Fields

• channelIds

Usage Example

HolodexClient holodexClient = new HolodexClient("HOLODEX_API_KEY");

ObjectMapper objectMapper = JsonMapper.builder()
                .addModule(new JavaTimeModule())
                .build();

GetQueryParameters getQueryParameters = new GetQueryParameters();
getQueryParameters.setChannelIds(new String[]{
                "UC5CwaMl1eIgY8h02uZw7u8A", // Suisei
                "UC1DCedRgGHBdm81E1llLhOQ", // Pekora
                "UCO_aKKYxn4tvrqPjcTzZ6EQ", // Fauna
                "UCMwGHR0BTZuLsmjY_NT5Pwg" // Ina
        });
        
List<Video> videos = holodexClient
                .getLiveOrUpcomingVideosForSetOfChannels(getQueryParameters);

System.out.println(objectMapper
    .writerWithDefaultPrettyPrinter()
    .writeValueAsString(videos));

Result Example

[ {
  "id" : "O9V_EFbgpKQ",
  "title" : "フリーチャットだよ! ▼ free chat room",
  "type" : "stream",
  "published_at" : "2020-01-21T14:36:28.000Z",
  "available_at" : "2024-10-30T15:00:00.000Z",
  "duration" : 0,
  "status" : "upcoming",
  "start_scheduled" : "2024-10-30T15:00:00.000Z",
  "live_viewers" : 0,
  "songcount" : 0,
  "channel" : {
    "id" : "UC5CwaMl1eIgY8h02uZw7u8A",
    "name" : "Suisei Channel",
    "english_name" : "Hoshimachi Suisei",
    "type" : "vtuber",
    "photo" : "https://yt3.ggpht.com/ytc/AGIKgqPUZZxHa5ICd-CZd6g5zBfvrJIo2fFB26JJozKuqw=s800-c-k-c0x00ffffff-no-rj-mo",
    "org" : "Hololive",
    "suborg" : "0x0th Generation",
    "inactive" : false
  }
}, {
  "id" : "-wDi3GKTs4k",
  "title" : "【マリメ2】大会コースや難しいコースやってみっか!!!【ホロライブ/宝鐘マリン】",
  "type" : "stream",
  "topic_id" : "Mario_Maker",
  "published_at" : "2023-05-07T05:45:44.000Z",
  "available_at" : "2023-05-07T10:59:28.000Z",
  "duration" : 0,
  "status" : "live",
  "start_scheduled" : "2023-05-07T11:00:00.000Z",
  "start_actual" : "2023-05-07T10:59:28.000Z",
  "live_viewers" : 46619,
  "songcount" : 0,
  "channel" : {
    "id" : "UCCzUftO8KOVkV4wQG1vkUvg",
    "name" : "Marine Ch. 宝鐘マリン",
    "english_name" : "Houshou Marine",
    "type" : "vtuber",
    "photo" : "https://yt3.ggpht.com/Z2QpYUZ4-jKoFR7Ms330gRQzjI2gZ4CB_uVP6f39YysxUe1u8icrtE07ffpRxCtpu9U65MWNDA=s800-c-k-c0x00ffffff-no-nd-rj",
    "org" : "Hololive",
    "suborg" : "ea3rd Generation (Fantasy)",
    "inactive" : false
  },
  "mentions" : [ {
    "id" : "UC1DCedRgGHBdm81E1llLhOQ",
    "name" : "Pekora Ch. 兎田ぺこら",
    "english_name" : "Usada Pekora",
    "type" : "vtuber",
    "photo" : "https://yt3.ggpht.com/ytc/AGIKgqN9PsyHmOH6WryOpjfzzMtly558rl_Sbq0WKBTPxQ=s800-c-k-c0x00ffffff-no-rj",
    "org" : "Hololive",
    "inactive" : false
  } ]
}, {
  "id" : "c7K6RInG3Dw",
  "title" : "【SCHEDULE & FREE CHAT】",
  "type" : "stream",
  "topic_id" : "talk",
  "published_at" : "2021-09-28T21:52:38.000Z",
  "available_at" : "2023-09-28T20:00:00.000Z",
  "duration" : 0,
  "status" : "upcoming",
  "start_scheduled" : "2023-09-28T20:00:00.000Z",
  "live_viewers" : 0,
  "songcount" : 0,
  "channel" : {
    "id" : "UCMwGHR0BTZuLsmjY_NT5Pwg",
    "name" : "Ninomae Ina'nis Ch. hololive-EN",
    "english_name" : "Ninomae Ina’nis",
    "type" : "vtuber",
    "photo" : "https://yt3.ggpht.com/f4uYWHJxiGwyXm8NUlm818N1MRnywtgL6wM8JdWqWsKBzI7v1eg8dxDWG7igkWuukUSiufydqPg=s800-c-k-c0x00ffffff-no-rj",
    "org" : "Hololive",
    "suborg" : "h English -Myth-",
    "inactive" : false
  }
} ]