Becoming a Supported Podcast Hosting Partner

Descript now supports one-click export to supported podcast hosting services.  

To be integrated as a supported Descript podcast 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.

Integration Instructions

When a customer exports (via Descript's Share > Publish) their final podcast in Descript, the audio will be uploaded to a share.descript.com page (example), and they’ll be presented with a confirmation dialog with quick links to push the audio to their podcast host and other services. 

Screen_Shot_2020-05-26_at_5.47.42_PM.png

Once you’re a supported partner, the user will be able to select your service to appear as a quick link.

The link will direct the user to your episode creation URL, with an argument that will allow you to grab the file from Descript, like this:

https://www.example.com/my/profile/descript_import/new?title=Overview&url=https%3A%2F%2Fshare.descript.com%2Fview%2Fa50ffa05-540c-4c62-a36e-4fb14035a9cf

You can then query https://share.descript.com/<descript_publish_id> to grab the desired data from the following <meta> tags:

<meta name="descript:audio" content="<link to the m4a audio file>">
<meta name="descript:video" content="<link to the mp4 video file>">
<meta name="descript:subtitles" content="<link to the subtitle file>">

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.

Screen_Shot_2020-05-26_at_5.32.10_PM.png

Some partners, particularly those importing video, should message the user via email or notifications when the asset is imported to your system. 

Screen_Shot_2020-05-26_at_5.34.55_PM.png

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.

FAQ

What are the media file specifications?

Content

Specs

Audio

m4a
44.1kHz sample rate
160kbps bitrate
channel count determined user project (1 or 2)

Video

mp4 container
h264 codec

Subtitles

WebVTT (.vtt) file
42 characters per line
Maximum 2 lines per card
Includes speaker names

 

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.