> ## 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 batch videos > Retrieve up to 1000 videos data based on IDs This endpoint allows you to retrieve multiple videos in a single request. Simply specify a list of video IDs, and the API will return the details of each video. This request supports batch processing, allowing you to retrieve **up to 1,000** videos in a single request. ### Price The cost of this request is based on the number of video chunks (by 50 videos) in the request. **For example:** * 1 video means 1 chunk * 50 videos means 1 chunk * 75 videos means 2 chunks * 100 videos means 2 chunks * 101 videos means 3 chunks * 1000 videos means 20 chunks. ## OpenAPI ````yaml post /batch/videos openapi: 3.1.0 info: version: 1.0.0 title: Poix API servers: - url: https://api.poix.io description: Production server security: [] paths: /batch/videos: post: summary: Get batch videos description: Retrieve up to 1000 videos data based on IDs operationId: getBatchVideos parameters: - 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 requestBody: content: application/json: schema: type: object properties: ids: type: array items: type: string minLength: 11 maxLength: 11 minItems: 1 maxItems: 1000 description: An array of video IDs to retrieve data for. example: - dQw4w9WgXcQ - yPYZpwSpKmA - eYuUAGXN0KM - C2xel6q0yao - yBwD4iYcWC4 minimum: 1 maximum: 1000 includeLocalizations: type: boolean description: Whether to include localized data. required: - ids additionalProperties: false example: ids: - dQw4w9WgXcQ - yPYZpwSpKmA - eYuUAGXN0KM - C2xel6q0yao - yBwD4iYcWC4 responses: '200': description: Successful response content: application/json: schema: type: object properties: totalResults: type: number data: type: array items: type: object properties: id: type: string publishedAt: type: string channelId: type: string title: type: string description: type: string thumbnails: type: object properties: default: type: object properties: url: type: string width: type: number height: type: number required: - url - width - height medium: type: object properties: url: type: string width: type: number height: type: number required: - url - width - height high: type: object properties: url: type: string width: type: number height: type: number required: - url - width - height required: - default - medium - high channelTitle: type: string tags: type: array items: type: string categoryId: type: string defaultLanguage: type: string defaultAudioLanguage: type: string viewCount: type: string likeCount: type: string commentCount: type: string topicCategories: type: array items: type: string uploadStatus: type: string privacyStatus: type: string license: type: string embeddable: type: boolean publicStatsViewable: type: boolean madeForKids: type: boolean hasPaidProductPlacement: type: boolean localizations: type: object additionalProperties: type: object properties: title: type: string description: type: string required: - title - description categoryTitle: type: string duration: type: string parsedDuration: type: number captionsUrl: type: string videoFileUrl: type: string audioFileUrl: type: string required: - id 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: '1575717222' likeCount: '17875159' commentCount: '2359576' 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 localizations: en: 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 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 ````