> ## Documentation Index > Fetch the complete documentation index at: https://docs.poix.io/llms.txt > Use this file to discover all available pages before exploring further. # Get videos details > Get details for a list of videos. ## OpenAPI ````yaml get /videos openapi: 3.1.0 info: version: 1.0.0 title: Poix API servers: - url: https://api.poix.io description: Production server security: [] paths: /videos: get: summary: Get videos details description: Get details for a list of videos. operationId: getVideosDetails parameters: - schema: type: string description: An array of video IDs to retrieve data for. required: true description: An array of video IDs to retrieve data for. name: ids in: query - schema: type: string enum: - af - am - ar - as - az - be - bg - bn - bs - ca - cs - da - de - el - en-GB - en-IN - en - es - es-419 - es-US - et - eu - fa - fi - fil - fr-CA - fr - gl - gu - hi - hr - hu - hy - id - is - it - iw - ja - ka - kk - km - kn - ko - ky - lo - lt - lv - mk - ml - mn - mr - ms - my - 'no' - ne - nl - or - pa - pl - pt - pt-PT - ro - ru - si - sk - sl - sq - sr-Latn - sr - sv - sw - ta - te - th - tr - uk - ur - uz - vi - zh-CN - zh-HK - zh-TW - zu description: The language to retrieve localized data in. required: false description: The language to retrieve localized data in. name: hl in: query - schema: type: string description: >- An array of fields to include in the response. If not provided, all fields will be returned. required: false description: >- An array of fields to include in the response. If not provided, all fields will be returned. name: fields in: query responses: '200': description: Successful response content: application/json: schema: type: object properties: totalResults: type: number description: Total number of video details returned. data: type: array items: type: object properties: id: type: string description: The unique ID of the video. publishedAt: type: string description: The date and time when the video was published. channelId: type: string description: The ID of the channel that owns the video. title: type: string description: The title of the video. description: type: string description: The description of the video. thumbnails: type: object properties: default: type: object properties: url: type: string description: The URL of the thumbnail image. width: type: number description: The width of the thumbnail image. height: type: number description: The height of the thumbnail image. required: - url - width - height medium: type: object properties: url: type: string description: The URL of the thumbnail image. width: type: number description: The width of the thumbnail image. height: type: number description: The height of the thumbnail image. required: - url - width - height high: type: object properties: url: type: string description: The URL of the thumbnail image. width: type: number description: The width of the thumbnail image. height: type: number description: The height of the thumbnail image. required: - url - width - height required: - default - medium - high description: >- The thumbnails for the video, available in different sizes. channelTitle: type: string description: The title of the channel that owns the video. tags: type: array items: type: string description: An array of tags associated with the video. categoryId: type: string description: The ID of the category the video belongs to. defaultLanguage: type: string description: The default language of the video. defaultAudioLanguage: type: string description: The default audio language of the video. viewCount: type: string description: The number of views the video has received. likeCount: type: string description: The number of likes the video has received. commentCount: type: string description: The number of comments on the video. topicCategories: type: array items: type: string description: >- An array of topic categories associated with the video. uploadStatus: type: string description: The upload status of the video. privacyStatus: type: string description: The privacy status of the video. license: type: string description: The license type of the video. embeddable: type: boolean description: Indicates if the video can be embedded. publicStatsViewable: type: boolean description: >- Indicates if the video statistics are publicly viewable. madeForKids: type: boolean description: Indicates if the video is made for kids. hasPaidProductPlacement: type: boolean description: Indicates if the video has paid product placement. localizations: type: object additionalProperties: type: object properties: title: type: string description: The localized title of the video. description: type: string description: The localized description of the video. required: - title - description description: Localized titles and descriptions for the video. categoryTitle: type: string description: The title of the category the video belongs to. duration: type: string description: The duration of the video. parsedDuration: type: number description: The parsed duration of the video in seconds. captionsUrl: type: string description: The URL for the video captions, if available. videoFileUrl: type: string description: The URL for the video file, if available. audioFileUrl: type: string description: The URL for the audio file, if available. required: - id description: Array of video detail objects. required: - totalResults - data example: totalResults: 1 data: - id: dQw4w9WgXcQ publishedAt: '2009-10-25T06:57:33Z' channelId: UCuAXFkgsw1L7xaCfnd5JJOw title: >- Rick Astley - Never Gonna Give You Up (Official Music Video) description: >- The official video for “Never Gonna Give You Up” by Rick Astley. The new album 'Are We There Yet?' is out now: Download here: https://RickAstley.lnk.to/AreWeThereYetFA/itunes “Never Gonna Give You Up” was a global smash on its release in July 1987, topping the charts in 25 countries including Rick’s native UK and the US Billboard Hot 100. It also won the Brit Award for Best single in 1988. Stock Aitken and Waterman wrote and produced the track which was the lead-off single and lead track from Rick’s debut LP “Whenever You Need Somebody”. The album was itself a UK number one and would go on to sell over 15 million copies worldwide. The legendary video was directed by Simon West – who later went on to make Hollywood blockbusters such as Con Air, Lara Croft – Tomb Raider and The Expendables 2. The video passed the 1bn YouTube views milestone on 28 July 2021. Subscribe to the official Rick Astley YouTube channel: https://RickAstley.lnk.to/YTSubID Follow Rick Astley: Facebook: https://RickAstley.lnk.to/FBFollowID Twitter: https://RickAstley.lnk.to/TwitterID Instagram: https://RickAstley.lnk.to/InstagramID Website: https://RickAstley.lnk.to/storeID TikTok: https://RickAstley.lnk.to/TikTokID Listen to Rick Astley: Spotify: https://RickAstley.lnk.to/SpotifyID Apple Music: https://RickAstley.lnk.to/AppleMusicID Amazon Music: https://RickAstley.lnk.to/AmazonMusicID Deezer: https://RickAstley.lnk.to/DeezerID Lyrics: We’re no strangers to love You know the rules and so do I A full commitment’s what I’m thinking of You wouldn’t get this from any other guy I just wanna tell you how I’m feeling Gotta make you understand Never gonna give you up Never gonna let you down Never gonna run around and desert you Never gonna make you cry Never gonna say goodbye Never gonna tell a lie and hurt you We’ve known each other for so long Your heart’s been aching but you’re too shy to say it Inside we both know what’s been going on We know the game and we’re gonna play it And if you ask me how I’m feeling Don’t tell me you’re too blind to see Never gonna give you up Never gonna let you down Never gonna run around and desert you Never gonna make you cry Never gonna say goodbye Never gonna tell a lie and hurt you #RickAstley #NeverGonnaGiveYouUp #WheneverYouNeedSomebody #OfficialMusicVideo thumbnails: default: url: https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg width: 120 height: 90 medium: url: https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg width: 320 height: 180 high: url: https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg width: 480 height: 360 standard: url: https://i.ytimg.com/vi/dQw4w9WgXcQ/sddefault.jpg width: 640 height: 480 maxres: url: https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg width: 1280 height: 720 channelTitle: Rick Astley tags: - rick astley - Never Gonna Give You Up - nggyu - never gonna give you up lyrics - rick rolled - Rick Roll - rick astley official - rickrolled - Fortnite song - Fortnite event - Fortnite dance - fortnite never gonna give you up - rick roll - rickrolling - rick rolling - never gonna give you up - 80s music - rick astley new - animated video - rickroll - meme songs - never gonna give u up lyrics - Rick Astley 2022 - never gonna let you down - animated - rick rolls 2022 - never gonna give you up karaoke categoryId: '10' defaultLanguage: en defaultAudioLanguage: en viewCount: '1576236315' likeCount: '17879517' commentCount: '2359970' topicCategories: - https://en.wikipedia.org/wiki/Electronic_music - https://en.wikipedia.org/wiki/Music - https://en.wikipedia.org/wiki/Pop_music - https://en.wikipedia.org/wiki/Rhythm_and_blues - https://en.wikipedia.org/wiki/Soul_music uploadStatus: processed privacyStatus: public license: youtube embeddable: true publicStatsViewable: true madeForKids: false hasPaidProductPlacement: false categoryTitle: Music duration: PT3M33S parsedDuration: 213 captionsUrl: http://localhost:9999/captions/dQw4w9WgXcQ videoFileUrl: http://localhost:9999/files/video/dQw4w9WgXcQ audioFileUrl: http://localhost:9999/files/audio/dQw4w9WgXcQ '400': description: Bad Request content: application/json: schema: type: object properties: success: type: boolean enum: - false error: type: object properties: issues: type: array items: type: object properties: code: type: string maximum: type: number type: type: string inclusive: type: boolean exact: type: boolean message: type: string path: type: array items: type: string received: type: string options: type: array items: type: string required: - code - message - path name: type: string enum: - ZodError required: - issues - name required: - success - error example: success: false error: issues: - received: subscriberCount code: invalid_enum_value options: - publishedAt - channelId - title - description - thumbnails - channelTitle - tags - categoryId - defaultLanguage - defaultAudioLanguage - viewCount - likeCount - commentCount - topicCategories - uploadStatus - privacyStatus - license - embeddable - publicStatsViewable - madeForKids - hasPaidProductPlacement - localizations - categoryTitle - duration - parsedDuration - captionsUrl - videoFileUrl - audioFileUrl path: - fields - 0 message: >- Invalid enum value. Expected 'publishedAt' | 'channelId' | 'title' | 'description' | 'thumbnails' | 'channelTitle' | 'tags' | 'categoryId' | 'defaultLanguage' | 'defaultAudioLanguage' | 'viewCount' | 'likeCount' | 'commentCount' | 'topicCategories' | 'uploadStatus' | 'privacyStatus' | 'license' | 'embeddable' | 'publicStatsViewable' | 'madeForKids' | 'hasPaidProductPlacement' | 'localizations' | 'categoryTitle' | 'duration' | 'parsedDuration' | 'captionsUrl' | 'videoFileUrl' | 'audioFileUrl', received 'subscriberCount' name: ZodError '403': description: Forbidden content: application/json: schema: type: object properties: error: type: object properties: message: type: string required: - message required: - error example: error: message: Forbidden security: - Bearer: [] components: securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT ````