Descript now supports one-click export to supported content hosting services.
To be integrated as a supported Descript content hosting solution, you’ll need to update your episode creation flow to support the import of episodes from a Descript URL. No API work is required - host integration is built on top of Descript’s Publish feature, which makes exported audio, video, and transcript metadata available at an easily accessible url.
To integrate, follow the instructions below. While the process is largely self service, please let us know if you are working on an integration, as we’ll need to add you to the app as a final step. We are also available to provide technical support if you need help with the integration.
Publish from Descript...
Import from Descript...
Integration Instructions
Step 1. Acquire the Descript URL from your user
https://www.example.com/my/profile/descript_import/new?title=Overview&url=https%3A%2F%2Fshare.descript.com%2Fview%2Fa50ffa05-540c-4c62-a36e-4fb14035a9cf
Step 2. Download the media
<meta property="descript:audio" content="<link to the m4a audio file>">
<meta property="descript:video" content="<link to the mp4 video file>">
Step 3. Download the transcript data
<meta property="descript:subtitles" content="<link to the subtitle (WebVTT) file>">
<meta property=“descript:transcript” content=“<link to the transcript JSON file>“>
Step 4. Include transcript data in a podcast feed
Best Practices
1. Polling
The user may click the link to your creation page before their file has completed exporting. To provide the best customer experience, we recommend polling the meta links until the asset is found.
While the asset is being generated, the media links will return either a 403 or 404 error. We recommend polling every 30 seconds to 1 minute with a max timeout of 3 hours.
The share.descript.com URL will include the metadata tags, with a link to the asset, even while the assets are being generated. Rather than having to poll the Descript page, then fetch the assets once the metadata tags appear, you should be able to fetch the Descript page once to get the asset URLs, then poll the asset URLs until the asset is ready.
2. Show progress in the UI
While polling is occurring on your app, the user should be notified that the final asset is processing.
Some partners, particularly those importing video, should message the user via email or notifications when the asset is imported to your system.
3. Create an “upload from Descript url” affordance on your episode creation page
Lets users know that you support Descript! This is particularly useful in case they’ve dismissed the original publish modal on your site.
Frequently Asked Questions
What are the media file specifications?
Content |
Specs |
Audio |
m4a |
Video |
mp4 container |
Subtitles |
WebVTT (.vtt) file |
I'm getting an error when importing.
Poll again. If those meta tags do exist, but the media file they point to is not found, then keep polling - the files are being rendered by Descript.
By default, this URL is publicly accessible by anyone without the need to login to their Descript accounts. In future updates, users may choose to prohibit their pages from being downloaded by partners. If there is no "descript:audio" or "descript:video" meta tag. Your applications error state should be something like "Import is disabled for this project."
Video publishes will only have a video URL, not an audio-only URL. Your applications will need to extra extract the audio from the mp4 video file.
I still need help with my integration.
Please fill out this form. Our Business Development team will get back to you within 2 business days.