> For the complete documentation index, see [llms.txt](https://yagato.gitbook.io/holodexwrapper/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yagato.gitbook.io/holodexwrapper/methods/getvideos-getqueryparameters.md).

# getVideos (GetQueryParameters)

## Returns

A List of Video objects matching the given parameters.

## Parameters

| Name               | Type                 |
| ------------------ | -------------------- |
| getQueryParameters | GetRequestParameters |

### Allowed Fields

* channelId
* from
* videoId
* extraInfo
* languages
* limit
* maxUpcomingHours
* mentionedChannelId
* offset
* order
* organization
* sortByField
* to
* topic
* type

## Usage Example

{% code lineNumbers="true" %}

```java
HolodexClient holodexClient = new HolodexClient("HOLODEX_API_KEY");

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

GetQueryParameters getQueryParameters = new GetQueryParameters();
getQueryParameters.setChannelId("UC5CwaMl1eIgY8h02uZw7u8A");

List<Video> videos = holodexClient.getVideos(getQueryParameters);

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

{% endcode %}

## Result Example

{% code lineNumbers="true" %}

```
[ {
  "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",
  "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" : "j2sYphBo0JO",
  "title" : "NHK VTuber Radio \"VR!\" #6 | Guests: Houshou Marine, Sakamata Chloe",
  "type" : "placeholder",
  "available_at" : "2023-05-14T13:40:00.000Z",
  "duration" : 3000,
  "status" : "upcoming",
  "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
  },
  "jp_name" : "ぶいあーる!〜VTuberの音楽Radio〜 第6回 ゲストは宝鐘マリン、沙花叉クロヱ",
  "link" : "https://radiko.jp/#!/live/JOAK-FM",
  "thumbnail" : "https://www.nhk.or.jp/prog/img/7763/g7763.jpg",
  "placeholderType" : "external-stream",
  "certainty" : "certain",
  "credits" : {
    "editor" : {
      "name" : "Nemu#2378",
      "user" : "8285"
    }
  }
}]
```

{% endcode %}