Custom Domains
We explain how the process works and what is needed to activate this feature in your account.
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
| Case | Configuration needed | | ---------------------- |
--------------------------------------------------------------------------------------------------- | | Live streaming |
live.mycustomdomain.comembed.mycustomdomain.com collector.mycustomdomain.com | | VOD | vod.mycustomdomain.com
embed.mycustomdomain.comcollector.mycustomdomain.com | | VOD and Live streaming | vod.mycustomdomain.com
live.mycustomdomain.com embed.mycustomdomain.comcollector.mycustomdomain.com |
Using an external player
| Case | Configuration needed | | ---------------------------------------------------------------- |
------------------------------------------------------------------------- | | VOD or Livestream using your own custom
player without analytics | vod.mycustomdomain.comlive.mycustomdomain.com | | VOD or Livestream using your own custom
player with analytics | vod.mycustomdomain.comlive.mycustomdomain.comcollector.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 CNAME → vod.api.video
- live.mycustomdomain.com CNAME → live.api.video
- embed.mycustomdomain.com CNAME → embed.api.video
- collector.mycustomdomain.com CNAME → collector.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.
