Tutorials · 4 min read

birds migrating

Migrating your videos to api.video

Migrating your videos to api.video couldn't be easier. With just a few API calls, you can get your video transferred into our service, and your customers' wont be able to tell the difference.

Doug Sillars

August 31, 2021

Migrating your videos to api.video from another video provider like Vimeo

If you are launching a new service with video - starting up with api.video is easy - you can just start adding your videos with our API, and everything works great. The best part? You don't need to pay any encoding fees. You migrate for free without paying any entry tax - or rather, encoding fees.

But, many of our customers have video content stored elsewhere. They’d rather not support 2 video services, and begin looking at migration options for their videos from to api.video. In this post, we will walk through the steps to copy any video source url to api.video. In this case, we will use the Vimeo API to show how to access the source URL from Vimeo.

if you are planning a large video migration from Vimeo (or any other provider), please give us a heads up so that we can ensure we have enough video encoding resources for our other customers.

Getting the source url from Vimeo

To upload your videos to api.video, you’ll need to get the source urls. In this example, we’ll use Vimeo as the example provider, but many other video providers provide similar access.

Using the Vimeo API, you’ll need to authenticate with a method that allows for private data, and then access the video endpoint for the video you’d like to transfer. The response of the query will include a series of video links.

There is a version for each encoding of the video. In most cases, you’ll want the source url, as your original file is of the highest quality of the versions available. Now that you have the source URL of your video at Vimeo, you are ready to transfer the file to api.video.

But, before you go ahead and do that, you might want to also access any other data you might want to bring across to api.video. This could include the public_name, description, any metadata you might have saved, the pictures.uri of the poster image, and any tags you might have associated with the video.

Create your video at api.video.

Now that you have a URL for the video, and all the metadata you might want to add to your ‘new’ video, we’re ready to create a video at api.video. This endpoint requires a token, but if you are using one of our SDKs, all you need is your API key.

When uploading a video, you’d first create the video, and then upload the file in a second step. But, we have a URL, so you can add the video source to the create API, and the video will be transferred asynchronously with just one API call.

When you create a video, you supply the source url to begin the upload, but you can also populate the title, description, metadata and tag attributes straight from the data you extracted from your previous video provider.

Once you call the create endpoint, the API call will return the videoId of your new api.video video. You can now make a second call to the upload a thumbnail endpoint with the videoId and url of the thumbnail. This will ensure that the poster for your video is exactly the same as it was with your previous video provider.

That’s all there is to it! You’ve now moved your first video from Vimeo to api.video, and you can automate the entire process for the migration.


If you have a URL for your video’s source, you can automate the migration of your videos from your current video provider to api.video. With just a few simple API calls, you can have all of your videos transferred to api.video with just a few calls for each video.

Try out more than 80 features for free

Access all the features for as long as you need.
No commitment or credit card required

Video API, simplified

Fully customizable API to manage everything video. From encoding to delivery, in minutes.

Built for Speed

The fastest video encoding platform. Serve your users globally with 140+ points of presence. 

Let end-users upload videos

Finally, an API that allows your end-users to upload videos and start live streams in a few clicks.


Volume discounts and usage-based pricing to ensure you don’t exceed your budget.