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

We are following the OpenAPI specs. You can find our API specs here.

Environments

EnvironmentURL
Productionhttps://ws.api.video
Sandboxhttps://sandbox.api.video

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.

Switching to the sandbox environment in the 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.

Security

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.

Limitation

Video upload (VOD) is limited in size and minutes. We support upload for videos that are:

  • at most 30 GiB in size.
  • at most 1440 minutes in length.

Pagination

All top-level API resources have support for bulk fetches via "list" API methods. For instance, you can list videos, list livestreams, etc.

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 pagination object:

"pagination": {
    "currentPage": 1,
    "currentPageItems": 25,
    "pageSize": 25,
    "pagesTotal": 2,
    "itemsTotal": 35,
    "links": [
      {
        "rel": "self",
        "uri": "/videos?currentPage=1&pageSize=25"
      },
      {
        "rel": "first",
        "uri": "/videos?currentPage=1&pageSize=25"
      },
      {
        "rel": "next",
        "uri": "/videos?currentPage=2&pageSize=25"
      },
      {
        "rel": "last",
        "uri": "/videos?currentPage=2&pageSize=25"
      }
    ]

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.

API Clients

Was this page helpful?