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"
  } ]
}