> For the complete documentation index, see [llms.txt](https://knowledgebase.fabricdata.com/origin/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.fabricdata.com/origin/apis-all/video-api-docs/videos.md). # Videos ## Redirect URL to video. > Returns a URL to the requested video. \[Video Format Specs]\( > \ > \*\*Formats:\*\* MP4 = 4, HLS = 11, Dash = 14, HSS = 12, HDS = 13\ > \ > \*\*MP4 KbRate:\*\* 80, 212, 450, 750, 1500, 2500(HD sources only), 5000 (sources >= 1080p) \ > \ > \*\*Adaptive Min/Max rate:\*\* 212000, 350000, 600000, 1200000, 2000000, 2500000, 3500000 \ > \ > \`URLs requested with a Demo account will always return max 750 kbps video. Full commercial account required for higher bitrates.\` ```json {"openapi":"3.1.1","info":{"title":"Video API","version":"1.0"},"tags":[{"name":"Videos"}],"servers":[{"url":"https://api.origin.fabricdata.com/api/Videos"}],"security":[{"ApiKeyHeader":[],"ApiKeyQuery":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","description":"Authorize requests passing your apiKey in HTTP header.","name":"Ocp-Apim-Subscription-Key","in":"header"}},"schemas":{"VideoResponse":{"title":"VideoResponse","properties":{"Url":{"type":"string"},"Expires":{"type":"string","format":"date-time"}},"description":"VideoResponse","type":"object"}}},"paths":{"/GetVideo/{Id}":{"get":{"tags":["Videos"],"summary":"Redirect URL to video.","description":"Returns a URL to the requested video. [Video Format Specs](https://developer.iva-api.com/docs/v1/video-formats)\n\n**Formats:** MP4 = 4, HLS = 11, Dash = 14, HSS = 12, HDS = 13\n\n**MP4 KbRate:** 80, 212, 450, 750, 1500, 2500(HD sources only), 5000 (sources >= 1080p) \n\n**Adaptive Min/Max rate:** 212000, 350000, 600000, 1200000, 2000000, 2500000, 3500000 \n\n `URLs requested with a Demo account will always return max 750 kbps video. Full commercial account required for higher bitrates.`","operationId":"GetVideo","parameters":[{"schema":{"type":"integer","format":"int64"},"name":"Id","in":"path","description":"Id of the Video from either MovieVideo, ShowVideo, SeasonVideo, EpisodeVideo object.","required":true},{"schema":{"type":"string","enum":["mp4","hls","hss","hds","dash"]},"name":"Format","in":"query","description":"Video format.","required":true},{"schema":{"type":"string","enum":["NOT_SET","mp4_80","mp4_212","mp4_450","mp4_750","mp4_1500","mp4_2500","mp4_5000","mp4_8000"]},"name":"KbRate","in":"query","description":"Video bit-rate required for MP4 content.","required":false},{"schema":{"type":"string","format":"date-time"},"name":"Expires","in":"query","description":"UTC Time to video link should expire. ISO 8601 Format: yyyy-mm-dd hh:mm:ss.ffffff0Z","required":true},{"schema":{"type":"string"},"name":"ReportTag","in":"query","description":"Report tag used in video analytics.","required":false},{"schema":{"type":"integer","format":"int32"},"name":"start","in":"query","description":"Position in seconds to start video playback.","required":false},{"schema":{"type":"integer","format":"int32"},"name":"end","in":"query","description":"Position in seconds to end video playback.","required":false},{"schema":{"type":"string","enum":["adap_212000","adap_350000","adap_600000","adap_1200000","adap_2000000","adap_2500000","adap_3500000"]},"name":"MinRate","in":"query","description":"Adaptive Maximum rate. (Depreciated, use adaptive minimum resolution instead)","required":false},{"schema":{"type":"string","enum":["adap_212000","adap_350000","adap_600000","adap_1200000","adap_2000000","adap_2500000","adap_3500000"]},"name":"MaxRate","in":"query","description":"Adaptive Minimum rate. (Depreciated, use adaptive minimum resolution instead)","required":false},{"schema":{"type":"string","enum":["RESOLUTION_QVGA","RESOLUTION_HVGA","RESOLUTION_480P","RESOLUTION_720P","RESOLUTION_1080P"]},"name":"AdaptiveMinimumResolution","in":"query","description":"Adaptive Minimum resolution. Default is QVGA (320 wide, 212Kbps)","required":false},{"schema":{"type":"string","enum":["RESOLUTION_QVGA","RESOLUTION_HVGA","RESOLUTION_480P","RESOLUTION_720P","RESOLUTION_1080P"]},"name":"AdaptiveMaximumResolution","in":"query","description":"Adaptive Maximum resolution. Default is 1080P Resolution.","required":false},{"schema":{"type":"integer","format":"int32"},"name":"AdaptiveClientManifestVersion","in":"query","description":"Adaptive Client Manifest Version (HLS, default = 3)","required":false},{"schema":{"type":"integer","format":"int32"},"name":"AdaptiveStartIndex","in":"query","description":"Adaptive Start Index. Default = 4, the 480P resolution.","required":false},{"schema":{"type":"string","enum":["Two","Three","Four","Five","Six","Seven","Eight","Nine","Ten","Fifteen","Twenty","Thirty"]},"name":"AdaptiveMinimumFragmentLength","in":"query","description":"Adaptive Minimum Fragment Length. Default is 10 seconds.","required":false}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoResponse"}},"application/xml":{"schema":{"$ref":"#/components/schemas/VideoResponse"}},"text/csv":{"schema":{"$ref":"#/components/schemas/VideoResponse"}},"text/html":{"schema":{"$ref":"#/components/schemas/VideoResponse"}}}},"204":{"description":"No content."},"400":{"description":"Bad request."},"401":{"description":"Unauthorized."},"403":{"description":"Forbidden. The subscription key does not have permission to access this method."},"404":{"description":"Not found. The item you requested could not be found or has been deleted."},"409":{"description":"Conflict."},"429":{"description":"Too many requests."},"500":{"description":"Internal server error."},"503":{"description":"Service unavailable."}},"deprecated":false}}}} ``` ## Returns a webvtt closed caption > Returns a webvtt closed caption ```json {"openapi":"3.1.1","info":{"title":"Video API","version":"1.0"},"tags":[{"name":"Videos"}],"servers":[{"url":"https://api.origin.fabricdata.com/api/Videos"}],"security":[{"ApiKeyHeader":[],"ApiKeyQuery":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","description":"Authorize requests passing your apiKey in HTTP header.","name":"Ocp-Apim-Subscription-Key","in":"header"}},"schemas":{"ClosedCaption":{"title":"ClosedCaption","properties":{"Id":{"type":"integer","format":"int64"},"VideoID":{"description":"ID of the Video associated with Closed Caption","type":"integer","format":"int32"},"CCFileData":{"type":"string"},"LanguageId":{"description":"ID of language of Closed Caption.","type":"integer","format":"int32"}},"description":"ClosedCaption","type":"object"}}},"paths":{"/ClosedCaptions/{VideoId}":{"get":{"tags":["Videos"],"summary":"Returns a webvtt closed caption","description":"Returns a webvtt closed caption","operationId":"GetClosedCaption","parameters":[{"schema":{"type":"integer","format":"int64"},"name":"VideoId","in":"path","required":true}],"responses":{"200":{"description":"OK.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClosedCaption"}},"application/xml":{"schema":{"$ref":"#/components/schemas/ClosedCaption"}},"text/csv":{"schema":{"$ref":"#/components/schemas/ClosedCaption"}},"text/html":{"schema":{"$ref":"#/components/schemas/ClosedCaption"}}}},"204":{"description":"No content."},"400":{"description":"Bad request."},"401":{"description":"Unauthorized."},"403":{"description":"Forbidden. The subscription key does not have permission to access this method."},"404":{"description":"Not found. The item you requested could not be found or has been deleted."},"409":{"description":"Conflict."},"429":{"description":"Too many requests."},"500":{"description":"Internal server error."},"503":{"description":"Service unavailable."}},"deprecated":false}}}} ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://knowledgebase.fabricdata.com/origin/apis-all/video-api-docs/videos.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.