Skip to main content
Custom Domains

We explain how the process works and what is needed to activate this feature in your account.

Diego Gutierrez avatar
Written by Diego Gutierrez
Updated this week

Introduction

This article will guide you through the process of adding a custom domain to your account. A custom domain allows you to use your own domain for your video assets. Please follow these steps to get started.

Pricing

Adding a custom domain comes with the following pricing options:

  • $60 for Video on Demand (VOD)

  • $60 for Livestream

  • $100 for both VOD and Livestream



Process

The request

To initiate the process, you need to simply click "Add Custom Domain" button within the Domains area.

Please note that this option is only available in the Production environment.

Your use case

Depending on how you plan to use api.video, you can decide whether you would like to get custom domains for VOD, Livestream, or both options. If you select both, you will get a discount rate.

After making your selection, our billing system will automatically process the charges after you click "Confirm Addon".

And voilà, you will only have to complete the 3 technical configuration steps.


Technical Configuration

Upon confirmation of payment, you will be given the option to set up your custom domains immediately or postpone it for later. If you choose to postpone it, you will encounter a CONFIGURATION NEEDED status.

To configure it, follow the steps described below:

Which player do you use?

Select the first option if you intend to utilize any of our available players, or choose the second option if you plan to use an external player.

When selecting your choice, you will be asked to submit specific certificates in the next step.

Providng TLS certificates and keys

api.video requires a valid TLS certificate for every custom domain that you want to use and also your certificate key.

Depending on your use case and the option you have choosen for the player, you might need separate sub-domains and separete certificates + keys for video, live, collector, and embed services as described below.

Using one of our players

Live streaming

live.mycustomdomain.comem

bed.mycustomdomain.com collector.mycustomdomain.com

VOD

vod.mycustomdomain.com embed.mycustomdomain.com

collector.mycustomdomain.com

VOD and Live streaming

vod.mycustomdomain.com live.mycustomdomain.com embed.mycustomdomain.com

collector.mycustomdomain.com

Using an external player

VOD or Livestream using your own custom player without analytics

vod.mycustomdomain.com

live.mycustomdomain.com

VOD or Livestream using your own custom player with analytics

vod.mycustomdomain.com

live.mycustomdomain.com

collector.mycustomdomain.com

Fill in the custom domains information and upload the certificates and keys:

Updating DNS records (Final step!)

You need to update your custom domain’s DNS records. Simply add a CNAME for every custom domain that you want to use. Each custom URL should point to api.video’s corresponding CDN.

  • video.mycustomdomain.com CNAMEvod.api.video

  • live.mycustomdomain.com CNAMElive.api.video

  • embed.mycustomdomain.com CNAMEembed.api.video

  • collector.mycustomdomain.com CNAMEcollector.api.video

The steps to update your custom domain’s DNS records are determined by the domain host that you use. Contact your domain host if you are unsure about the specific steps of updating the DNS records.

At this point you will encounter a PROCESSING status.


Start using your new video or live domain

After you have updated your DNS records and provided the corresponding TLS certificates, api.video will enable traffic for each custom domain that you want to use and this process usually takes a few hours.
​Once everything is configured on our side we will let you know by email and you will have a LIVE status.

If you have any questions, feel free to reach out to us!

Did this answer your question?