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.
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
2.1. 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
And voilà, you will only need to complete the 3 steps technical configuration.
2.2. 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 domains for
embed services as described below.
Using one of our players
live.mycustomdomain.com, embed.mycustomdomain.com, collector.mycustomdomain.com
video.mycustomdomain.com , embed.mycustomdomain.com,
VOD and Live streaming
video.mycustomdomain.com, live.mycustomdomain.com, embed.mycustomdomain.com,
Using an external player
VOD/Live using your own custom player without analytics
VOD/Live using your own custom player with analytics
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.
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
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
If you have any questions, feel free to reach out to us!