getVideoMetadata

Method that makes a GET request to https://holodex.net/api/v2/videos/{videoId}

Note

videoId is required to use this method.

Returns

A Video object matching the given parameters.

Parameters

Name
Type
Description

videoId

String

The video's ID

timestampComments

Integer

Flag that indicates whether or not to append timestamp comments for this video. Allowed values: 0 and 1.

languages

String[]

Array of language codes to filter channels/clips. Official streams don't follow this parameter.

Usage Example

HolodexClient holodexClient = new HolodexClient("HOLODEX_API_KEY");

ObjectMapper objectMapper = JsonMapper.builder()
                .addModule(new JavaTimeModule())
                .build();
                
Video video = holodexClient.getVideoMetadata("Puyd1d445IM", 1,
                new String[]{Language.EN, Language.ES});

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

Result Example

{
  "id" : "Puyd1d445IM",
  "title" : "ใ€SUPER MARIO MAKER 2ใ€‘ Kirin plays impossible Mario levels to try to get good in 2 days (Day 1)",
  "type" : "stream",
  "topic_id" : "Mario_Maker",
  "published_at" : "2023-05-05T04:08:48.000Z",
  "available_at" : "2023-05-04T22:00:08.000Z",
  "duration" : 17509,
  "status" : "past",
  "start_scheduled" : "2023-05-04T22:00:00.000Z",
  "start_actual" : "2023-05-04T22:00:08.000Z",
  "end_actual" : "2023-05-05T02:51:51.000Z",
  "live_viewers" : 0,
  "description" : "TOURNAMENT PRACTICE TEAM B LET'S GO\n\nโœฟ Artist Credits โœฟ\nThumbnail: https://twitter.com/midokusuruuu/status/1653683887883825152\nThank you so much!! ๐Ÿ’š\n\nNintendo properties used in this video and livestream are used with permission and under license by Nintendo Co., Ltd.\n\nโœฟ Hashtags โœฟ\nLIVE: #faunline ART: #FineFaunart\n\nโœฟ Twitter โœฟ\nhttps://twitter.com/ceresfauna\n@ceresfauna\n\nเผปโ”โ”โ”เผบ .โ‹… โœง โ‹…. เผปโ”โ”โ”เผบ\n\n ใ€Tsukumo Sanaใ€‘\n[YouTube] https://t.co/rmtApAWdl3?amp=1\n[Twitter] https://twitter.com/tsukumosana\n\n ใ€Ouro Kroniiใ€‘\n[YouTube] https://t.co/P3BX2MUiCX?amp=1\n[Twitter] https://twitter.com/ourokronii\n\n ใ€Nanashi Mumeiใ€‘\n[YouTube] https://t.co/oO4kBazKMv?amp=1\n[Twitter] https://twitter.com/nanashimumei_en\n\n ใ€Hakos Baelzใ€‘\n[YouTube] https://t.co/X17xhp1Bty?amp=1\n[Twitter] https://twitter.com/hakosbaelz\n\nเผปโ”โ”โ”เผบ .โ‹… โœง โ‹…. เผปโ”โ”โ”เผบ\n\nใ€ FauForest Rules! ใ€‘\n\nโ–บ Be kind and respectful to everyone here! Donโ€™t spam or troll.\nโ–บ If you see spam or trolling, donโ€™t respond. Just block, report, and ignore those comments. \nโ–บ Talk about the stream, but please donโ€™t bring up unrelated topics or have personal conversations.\nโ–บ Donโ€™t bring up other streamers or streams unless I mention them first.\nโ–บ Similarly, donโ€™t talk about me or my stream in other streamersโ€™ chat.\nโ–บ Try your best not to backseat. I like to enjoy games at my own pace, and I think part of the fun is watching me struggle, so please refrain from offering advice unless I specifically ask for help!\n\nAs long as you follow the rules above, you can chat in any language.\n\nเผปโ”โ”โ”เผบ .โ‹… โœง โ‹…. เผปโ”โ”โ”เผบ\n\nใ€CREDITSใ€‘\nStream Layouts: Melonturtle (https://twitter.com/Melonturtle_)\nLogo: ใ”ใ”ใ‚“ (https://twitter.com/gogon_illust)\nCustom BGM: Arkhand (https://twitter.com/the_arkhand)\nEmotes: Maerie (https://twitter.com/maeriette)\nStinger Transition: UWU Media (https://twitter.com/uwumedia)\nBirthday Stream Background: reNPC (https://twitter.com/reNPCarts)\nBedroom Stream Background: 7MC (https://twitter.com/7MC_Official)\nStarting/Ending Screen: Shieriru (https://twitter.com/shieriru_55)\n\nไฝฟ็”จBGM \nโ–กDOVA-SYNDROME ใ€€\nHP๏ผšhttps://dova-s.jp/\nLicense : https://dova-s.jp/_contents/license/\nโ–กAUDIOSTOCK\nHP๏ผšhttps://audiostock.jp/\nLicense : https://audiostock.jp/help/usage\n\nเผปโ”โ”โ”เผบ .โ‹… โœง โ‹…. เผปโ”โ”โ”เผบ\n\n[Fan Work Guidelines]\nhttps://en.hololive.tv/terms\n\nRequest from hololive Production to underage viewers:\nPlease be sure to check the link below before viewing our content.\nhttps://en.hololive.tv/request-to-minors\n\nเผปโ”โ”โ”เผบ .โ‹… โœง โ‹…. เผปโ”โ”โ”เผบ\n\n[Official Online Shop]\nhttps://hololive.booth.pm/\n\n[Holoschedule] (Check all members streaming schedules)\nhttps://schedule.hololive.tv/#hololive\n\nเผปโ”โ”โ”เผบ .โ‹… โœง โ‹…. เผปโ”โ”โ”เผบ\n\n[Hololive Production]\nใƒปHololive English YouTube Channel: https://t.co/LcYDgFF9V0?amp=1\nใƒปHololive Production Official Twitter: https://twitter.com/hololivetv\nใƒปHololive English Official Twitter: https://twitter.com/hololive_En\nใƒปHololive English Official Reddit: https://www.reddit.com/r/Hololive/\n\nเผปโ”โ”โ”เผบ .โ‹… โœง โ‹…. เผปโ”โ”โ”เผบ\n\n#holoCouncil\n#hololiveEnglish",
  "songcount" : 0,
  "channel" : {
    "id" : "UCO_aKKYxn4tvrqPjcTzZ6EQ",
    "name" : "Ceres Fauna Ch. hololive-EN",
    "english_name" : "Ceres Fauna",
    "type" : "vtuber",
    "photo" : "https://yt3.ggpht.com/cBtserkb211p6If2OewgWd8oriIKRkfwTcP4_Vdq2YETG5TK9Q02v4cYmnLU03KBAJ0gcDha7oQ=s800-c-k-c0x00ffffff-no-rj",
    "org" : "Hololive",
    "suborg" : "ibEnglish (CouncilRyS)",
    "video_count" : "386",
    "subscriber_count" : "723000",
    "view_count" : "73754792",
    "clip_count" : "5534",
    "inactive" : false
  },
  "clips" : [ {
    "id" : "AEcfOILZOZ0",
    "lang" : "en",
    "title" : "๐…๐จ๐ซ ๐…๐š๐ฎ๐ง๐š, ๐Š๐ซ๐จ๐ง๐ข๐ข ๐ข๐ฌ ๐ก๐ž๐ซ ๐ฌ๐š๐ง๐ข๐ญ๐ฒ ๐ฆ๐ž๐๐ข๐œ๐š๐ญ๐ข๐จ๐ง",
    "type" : "clip",
    "available_at" : "2023-05-05T04:37:35Z",
    "duration" : 80,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCk5Ui4JNiUPDDH1LC6CqiZg",
      "name" : "Clozt",
      "photo" : "https://yt3.ggpht.com/-fWWZzM-aR7U83875HMM0IN1LYS-AFk_PV__BxbGv85mQjWr7KXUtd_vmuOteiazZ-R7QwZ-=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "Ly6CGABvxKc",
    "lang" : "en",
    "title" : "Fauna-sensei's lesson about mammal's eggs (Hololive/Eng Sub)",
    "type" : "clip",
    "available_at" : "2023-05-05T04:16:07Z",
    "duration" : 91,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UC_KFVMp8bgy6IIpYYNsUNog",
      "name" : "Pretamax",
      "photo" : "https://yt3.ggpht.com/SV9ZddtnJ_KWP-0VbUVIuzKOUEhA_W057H5IerXxRDi0RtRmc9R5Ok-Eq2hOSf_WuccTUAEH_gU=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "GIYfaiyZT04",
    "lang" : "en",
    "title" : "[ENG SUB/Hololive] Fauna has a wholesome date with Kronii",
    "type" : "clip",
    "available_at" : "2023-05-05T03:16:39Z",
    "duration" : 48,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UC6gtXKG7i_1Rv9_aGEVWXFA",
      "name" : "The Arrow๐ŸŽฅ ่‰ Clipper",
      "photo" : "https://yt3.ggpht.com/fZyqvxq_yIbGuxpiJI7oGfS6sOKAf2TYTIQbrLaG8DWt-lsd_SxaYN5hEiLxYTyX5OQCp36l_g=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "ILQfw8PvOGM",
    "lang" : "en",
    "title" : "Kronii Shows Fauna Her Gaming Skill IRL",
    "type" : "clip",
    "available_at" : "2023-05-05T08:11:50Z",
    "duration" : 46,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCUY4NGgaom5tDxhe4b1YX0g",
      "name" : "Nerrev",
      "photo" : "https://yt3.ggpht.com/lsHR2d5oSDvgYym1B-oKaGycMrop_KmFl_elfHR-moQTGRLrxKsvsKVylvDQ_90HVMk-zvOFqQ=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "FofWNuR_KM4",
    "lang" : "en",
    "title" : "Kronii Showed Fauna Her Memes",
    "type" : "clip",
    "available_at" : "2023-05-05T06:05:36Z",
    "duration" : 49,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCUY4NGgaom5tDxhe4b1YX0g",
      "name" : "Nerrev",
      "photo" : "https://yt3.ggpht.com/lsHR2d5oSDvgYym1B-oKaGycMrop_KmFl_elfHR-moQTGRLrxKsvsKVylvDQ_90HVMk-zvOFqQ=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "2p1i7S2vqDY",
    "lang" : "en",
    "title" : "Fauna was so embarassed of her snort, she had to hide under the desk",
    "type" : "clip",
    "available_at" : "2023-05-05T11:46:10Z",
    "duration" : 92,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCWrHUQo0T5lot1etA1gBMpA",
      "name" : "SlackFunday Ch.",
      "photo" : "https://yt3.ggpht.com/xFZwzyxKE6aZChNIFVgSPlPeCE37TIVxivFfkrcucLWcqKcAFnIKObDez-xKujvEdnypuopcIQ=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "M18c5TC307A",
    "lang" : "en",
    "title" : "๐™๐™–๐™ช๐™ฃ๐™– ๐™ฅ๐™ง๐™ค๐™—๐™–๐™—๐™ก๐™ฎ ๐™จ๐™ฉ๐™ง๐™š๐™–๐™ข๐™จ ๐™ฌ๐™ž๐™ฉ๐™๐™ค๐™ช๐™ฉ ๐™ฌ๐™š๐™–๐™ง๐™ž๐™ฃ๐™œ ๐™ฅ๐™–๐™ฃ๐™ฉ๐™จ...",
    "type" : "clip",
    "available_at" : "2023-05-05T13:09:01Z",
    "duration" : 34,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCwcenN2ozUtkGOVnge9XwQg",
      "name" : "HoloCrumb Ch.",
      "photo" : "https://yt3.ggpht.com/JmjwaygVz6c8zcRbRepy5hOSTKtIc3wbMwzGGcbDAh94HKFmnVjUSvFkjNnaD7AeiHLioaNUfg=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "tHObnWrP1eE",
    "lang" : "en",
    "title" : "Fauna Glad She Can Hang out with Kronii",
    "type" : "clip",
    "available_at" : "2023-05-05T23:38:05Z",
    "duration" : 61,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCUY4NGgaom5tDxhe4b1YX0g",
      "name" : "Nerrev",
      "photo" : "https://yt3.ggpht.com/lsHR2d5oSDvgYym1B-oKaGycMrop_KmFl_elfHR-moQTGRLrxKsvsKVylvDQ_90HVMk-zvOFqQ=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "shPHBjaPL8U",
    "lang" : "en",
    "title" : "RubberRoss' Level Caused FAUNA'S BIGGEST RAGE EVER",
    "type" : "clip",
    "available_at" : "2023-05-06T02:38:17Z",
    "duration" : 900,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCaV5i9hR_vepxazrhc3zPCw",
      "name" : "SJtree",
      "photo" : "https://yt3.ggpht.com/ytc/AGIKgqPj4IpPwVKzFOCHq8zi7TWs2lhsxeL2-CDPXweHxA=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "tsrcNBFCJ-s",
    "lang" : "en",
    "title" : "Boomer Fauna Did The Zoomer Thing PERFECTLY",
    "type" : "clip",
    "available_at" : "2023-05-06T08:10:19Z",
    "duration" : 133,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UChzJTbxs5kTvxgAklhCwh3A",
      "name" : "OsekkaiใŠใ›ใฃใ‹ใ„",
      "photo" : "https://yt3.ggpht.com/ytc/AGIKgqOYTxz0dFtsGbINVIRveJob5lCKzCCoaWf7r0q5=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "LX718Wx1BpM",
    "lang" : "en",
    "title" : "Fauna Really Like Talking with Kroni",
    "type" : "clip",
    "available_at" : "2023-05-05T18:49:28Z",
    "duration" : 72,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCUY4NGgaom5tDxhe4b1YX0g",
      "name" : "Nerrev",
      "photo" : "https://yt3.ggpht.com/lsHR2d5oSDvgYym1B-oKaGycMrop_KmFl_elfHR-moQTGRLrxKsvsKVylvDQ_90HVMk-zvOFqQ=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "GXdiuWXqEsc",
    "lang" : "en",
    "title" : "Fauna Debut Vs Fauna Now",
    "type" : "clip",
    "available_at" : "2023-05-07T03:44:25Z",
    "duration" : 49,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UC0QvckA6UV5JxMasMuDCjdQ",
      "name" : "HoloChips Ch.",
      "photo" : "https://yt3.ggpht.com/r8jhi9iXKUeiTR7IW3x4fs39ReOS4zPNwbAiBkclPr7q1zDac9UP0YewI-TtZQglS0B5QmXK=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "YpWts6Obvvs",
    "lang" : "en",
    "title" : "Fauna's Favorite Character In Better Call Saul",
    "type" : "clip",
    "available_at" : "2023-05-07T04:30:10Z",
    "duration" : 125,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UC0QvckA6UV5JxMasMuDCjdQ",
      "name" : "HoloChips Ch.",
      "photo" : "https://yt3.ggpht.com/r8jhi9iXKUeiTR7IW3x4fs39ReOS4zPNwbAiBkclPr7q1zDac9UP0YewI-TtZQglS0B5QmXK=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  }, {
    "id" : "BfMfFpBIOSo",
    "lang" : "zh",
    "title" : "็ทšไธ‹้€ฃๅ‹•(? Faunaๅ’ŒKroniiไธ€่ตทๅŽป็Žฉไบ†!ใ€Ceres Faunaใ€‘ใ€hololive-ENใ€‘ใ€ไธญ่‹ฑๅญ—ๅน•ใ€‘",
    "type" : "clip",
    "available_at" : "2023-05-05T12:32:45Z",
    "duration" : 78,
    "status" : "past",
    "live_viewers" : 0,
    "songcount" : 0,
    "channel" : {
      "id" : "UCu10EBMRL1SZm3Bwx_7lyJA",
      "name" : "DD็ƒค่‚‰MAN",
      "photo" : "https://yt3.ggpht.com/xR-c8gKx7byA6hk-kZgUgW75qW5-tTclZmSwMg8S9Yi77ruFgViMXgcAoIr8XTWy9yrQEUhVIw=s800-c-k-c0x00ffffff-no-rj",
      "inactive" : false
    }
  } ],
  "comments" : [ {
    "comment_key" : "UgyDOj-Pz-10VApnTYl4AaABAg",
    "message" : "4:31:01 you're welcome. \n\n....I'm so sorry Fauna...someone had to do it! "
  }, {
    "comment_key" : "UgzFA28_RcU458HMdqB4AaABAg",
    "message" : "1:33:50 ok that was straight-up bull@#$&$#. I'm writing a stern letter to Mr. Nintendo himself. (My uncle works for him)"
  }, {
    "comment_key" : "UgwUhN69menSQeiE01V4AaABAg",
    "message" : "4:31:00 mmmmmmhmmmmm, yes"
  }, {
    "comment_key" : "UgwThi483eNLr7td6Kt4AaABAg",
    "message" : "1:32:39 Pizza rapping Fauna. I've noticed Holo talents always get a gamer buff when they sing some sort of song when they play."
  }, {
    "comment_key" : "Ugy2uSFPnb-7t61EX4B4AaABAg",
    "message" : "1:47 Konfauna"
  }, {
    "comment_key" : "Ugw9axHg81nTQOFJSVJ4AaABAg",
    "message" : "1:45 stream start :)"
  }, {
    "comment_key" : "Ugw1xJvGJQ8XWh0Fbd54AaABAg",
    "message" : "Clear rate of \"Switchy Sands\" map,\n\nBefore Fauna: 0.45% (48/10652) 1:50:41\nAfter Fauna: 0.39% (49/12270) 4:20:40\n\nMeaning, 1,618 attempts during the time Fauna was playing but there was also 1 successful clear during that time so not all the attempts were from only Fauna."
  }, {
    "comment_key" : "Ugw_RiGXwwMe_O9gRsJ4AaABAg",
    "message" : "4:31:00 *Rare Fauna Snort TSKR!!!*"
  }, {
    "comment_key" : "UgzK22QaITtCOZnuvRF4AaABAg",
    "message" : "4:25:58 to 4:26:42 - I have to tell you, Fauna, hearing you talk about watching Jon's _Kaizo_ videos and getting into Let's Plays because of that on stream kind of puts a smile on my face, since those videos were the first of his that I've watched when I was a kid. It's also kind of funny in a strange way that Jon is forever attached to _Kaizo_ all these years later...and all because he just wanted to see someone eat a hat...and very coincidental that those videos sort of led to you wanting to be a streamer now since Jon currently is active as a full-time Twitch streamer. (Coincidentally, he also likes interacting with chat, same as you.)\n\nHe still does Let's Plays, mostly with his collab group The Runaway Guys, and he's since done a lot of good things, including an annual charity event he does with his fellow content-creating friends for Direct Relief since 2018, TRG has their own game show panel, Thrown Controllers, which got back into gear this year, this year marked 16 years since he started doing content on the internet, and I could go on but I'll just stop right there. Oh, and he also runs two podcasts - both with friends, one that's weekly and one that's monthly."
  }, {
    "comment_key" : "UgyIzb-ZNOsjjeXZ1mN4AaABAg",
    "message" : "45:10 toad fauna"
  } ]
}

Last updated