api.video API reference
This page describes how to authenticate, set up, and securely implement the api.video API solutions with your product.
api.video API is built with the REST API standard, the most common standard used today.
OpenAPI & Swagger
There are two environments that you can utilize right now. Before you upgrade your account to paid account, you are working in Sandbox mode.
Once you've upgraded you can switch between sandbox and production by toggling the button on the overview page on the api.video dashboard.
The sandbox mode has these limitations
- Limited to 30 seconds videos and live streams.
- Will include an unremovable watermark
- Videos or recorded live streams will be deleted after 24 hours, after upload or recording.
Follow these best practices to secure your API keys:
- Do not embed API keys directly in code. API keys that are embedded in code can be accidentally exposed to the public. For example, you may forget to remove the keys from code that you share. Instead of embedding your API keys in your applications, store them in environment variables or in files outside of your application’s source tree.
- Do not store API keys in files inside your application’s source tree. If you store API keys in files, keep the files outside your application’s source tree to help ensure your keys do not end up in your source code control system. This is particularly important if you use a public source code management system such as GitHub.
- Review your code before publicly releasing it. Ensure that your code does not contain API keys or any other private information before you make your code publicly available.
- Delete unneeded API keys to minimize exposure to attacks.
- Limit one API key pair's usage to a specific system of your platform backend. This limits the scope of each key. If an API key is compromised, you can delete or regenerate the impacted key without needing to update your other API keys.
Video upload (VOD) is limited in size and minutes. We support upload for videos that are:
- at most 20 GiB in size.
- at most 1440 minutes in length.
Each of the responses has next, previous, first, last and self URLs formatted query strings provided for easier querying of the results pages. You can use the limit parameter to define the number of results on a page.
If for example you have created 900 videos, after calling
GET https://ws.api.video/videos?pageSize=25 you will receive a response that lists 25 videos. At the bottom of the response is the
In order to retrieve the next 25 videos, you will need to make another request with the page number, and you can pull it from the object
links with the
rel: "next" value. A call to
GET https://ws.api.video/videos?currentPage=2&pageSize=25z will give you the next 25 videos.
|PHP API Client||Android API Client||Go API Client|
|C# API Client||Swift SDK||Node.js API Client|
|Python API Client||Java API Client|
Was this page helpful?