> ## 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 related videos > This endpoint retrieves a list of videos related to a specified video. This endpoint retrieves a list of videos related to a specified video, in the same order the provider ranks them. The source video is never included in the results, and duplicates across pages are removed. Each page returns up to 20 videos. Use the `pages` parameter to request more, up to a maximum of 10 pages. This endpoint is backed by Poix's related-videos provider rather than the YouTube Data API, so it consumes **no YouTube quota units**. ### Price The cost of this request is \$0.00003 per request plus \$0.0005 per page fetched: | `pages` | Total cost | | ----------- | ---------- | | 1 (default) | \$0.00053 | | 5 | \$0.00253 | | 10 | \$0.00503 | Only pages that are actually fetched are billed. If the provider runs out of results before reaching the number of pages you requested, you are charged for the pages that were fetched — the `pagesFetched` field in the response tells you exactly how many that was. ## OpenAPI ````yaml get /relatedVideos openapi: 3.1.0 info: version: 1.0.1 title: Poix API servers: - url: https://api.poix.io description: Production server security: [] paths: /relatedVideos: get: tags: - Search summary: Get related videos description: This endpoint retrieves a list of videos related to a specified video. operationId: getRelatedVideos parameters: - schema: type: string minLength: 1 description: The ID of the video to retrieve related videos for. required: true description: The ID of the video to retrieve related videos for. name: videoId in: query - schema: type: string default: '1' description: >- The number of provider pages to fetch, each returning up to 20 videos. Between 1 and 10. Each page that is actually fetched is billed; if the provider runs out of results early, only the pages that were fetched are charged. required: false description: >- The number of provider pages to fetch, each returning up to 20 videos. Between 1 and 10. Each page that is actually fetched is billed; if the provider runs out of results early, only the pages that were fetched are charged. name: pages in: query - schema: type: string enum: - AD - AE - AF - AG - AI - AL - AM - AN - AO - AQ - AR - AS - AT - AU - AW - AX - AZ - BA - BB - BD - BE - BF - BG - BH - BI - BJ - BM - BN - BO - BR - BS - BT - BV - BW - BY - BZ - CA - CC - CD - CF - CG - CH - CI - CK - CL - CM - CN - CO - CR - CU - CV - CX - CY - CZ - DE - DJ - DK - DM - DO - DZ - EC - EE - EG - EH - ER - ES - ET - EU - FI - FJ - FK - FM - FO - FR - GA - GB - GD - GE - GF - GG - GH - GI - GL - GM - GN - GP - GQ - GR - GS - GT - GU - GW - GY - HK - HM - HN - HR - HT - HU - ID - IE - IL - IM - IN - IO - IQ - IR - IS - IT - JE - JM - JO - JP - KE - KG - KH - KI - KM - KN - KP - KR - KW - KY - KZ - LA - LB - LC - LI - LK - LR - LS - LT - LU - LV - LY - MA - MC - MD - ME - MG - MH - MK - ML - MM - MN - MO - MP - MQ - MR - MS - MT - MU - MV - MW - MX - MY - MZ - NA - NC - NE - NF - NG - NI - NL - 'NO' - NP - NR - NU - NZ - OM - PA - PE - PF - PG - PH - PK - PL - PM - PN - PR - PS - PT - PW - PY - QA - RE - RO - RS - RU - RW - SA - SB - SC - SD - SE - SG - SH - SI - SJ - SK - SL - SM - SN - SO - SR - ST - SV - SY - SZ - TC - TD - TF - TG - TH - TJ - TK - TL - TM - TN - TO - TR - TT - TV - TW - TZ - UA - UG - UM - US - UY - UZ - VA - VC - VE - VG - VI - VN - VU - WF - WS - XK - YE - YT - ZA - ZM - ZW description: >- Instructs the API to return results as if the request was made from a specific country. The parameter value is an ISO 3166-1 alpha-2 country code. required: false description: >- Instructs the API to return results as if the request was made from a specific country. The parameter value is an ISO 3166-1 alpha-2 country code. name: regionCode in: query - schema: type: string enum: - en - es - de - fr - ja - pt - tr - it - fa - nl - af - am - ar - as - az - be - bg - bn - bs - ca - cs - da - el - en-GB - en-IN - es-419 - es-US - et - eu - fi - fil - fr-CA - gl - gu - hi - hr - hu - hy - id - is - iw - ka - kk - km - kn - ko - ky - lo - lt - lv - mk - ml - mn - mr - ms - my - 'no' - ne - or - pa - pl - pt-PT - ro - ru - si - sk - sl - sq - sr-Latn - sr - sv - sw - ta - te - th - uk - ur - uz - vi - zh-CN - zh-HK - zh-TW - zh-Hans - zu description: The language to retrieve localized data in. required: false description: The language to retrieve localized data in. name: hl in: query responses: '200': description: Successful response content: application/json: schema: type: object properties: totalResults: type: number description: Total number of related videos returned. pagesFetched: type: number description: >- The number of provider pages actually fetched for this request. This is what the request was billed for, and it can be lower than the requested `pages` when the provider has no further results. data: type: array items: type: object properties: videoId: type: string description: The ID of the related video. title: type: string description: The title of the related video. channelId: type: string description: >- The ID of the channel that published the video. Omitted when the provider does not expose channel details for this video. channelHandle: type: string description: >- The handle of the channel that published the video, including the leading "@". channelTitle: type: string description: The title of the channel that published the video. viewCount: type: number description: The number of views the video has. publishedAt: type: string description: >- The date the video was published, in ISO 8601 format. The provider reports day precision, so the time component is always midnight UTC. required: - videoId - title - viewCount - publishedAt description: Array of related video objects. required: - totalResults - pagesFetched - data example: totalResults: 3 pagesFetched: 1 data: - videoId: 3ix8kNGRwxE title: >- The Lord Of The Rings | When Hope Moves In Silence — Emotional Deep Focus channelId: UCyPNg3TV04kk4FF5laSoROA channelHandle: '@CinematicSoulChannel' channelTitle: CinematicSoul viewCount: 698000 publishedAt: '2026-01-17T00:00:00Z' - videoId: t-yD25Kbv6c title: >- Read with Aragorn in Rivendell 🌿 | LOTR Ambient Music for Peace, Focus & Reflection channelId: UCBGbmFOOYnXWTIWzsJNADbQ channelHandle: '@QuietHourAmbience' channelTitle: The Quiet Hour viewCount: 348000 publishedAt: '2026-01-17T00:00:00Z' - videoId: B5Lfey8nBYM title: Well... now I understand why he's the perfect Aragorn viewCount: 230000 publishedAt: '2026-07-17T00:00:00Z' '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 expected: type: string received: type: string maximum: type: number type: type: string inclusive: type: boolean exact: type: boolean message: type: string path: 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: - code: invalid_type expected: string received: undefined path: - videoId message: Required 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 ````