ART19 offers API access for network and series owners. Please contact support to request credentials. If you're not an owner of the network or series, please CC a contact from the account for approval. We encourage you to provide as much context about your API use case/s as possible so we can make sure it will meet your business needs. We offer limited support when it comes to player customizations via the API on external sites.
You can find our API docs here: https://art19.com/developers
What can the API do?
You can:
- Create and publish episodes
- Configure and manage ad markers
- Manage series, episode and season artwork
- Manage feeds, credits, seasons, and more
- Build an embeddable player from our Player API
You can't:
- Retrieve episode or series analytics
- View or modify Ad Ops profile data, such as insertions order, line items, or ads
FAQs
| Question | Solution |
| API call not working? | Please contact support and provide the request info. |
| How can I get more info about how to use the API? | Visit https://art19.com/developers. |
| Why can I see thousands of series and not just my own? | All credentials will have access to active series with a public page enabled (on ART19). Utilizing a filter to limit the result to series associated with your account is recommended. See our documentation for more information. |
| Can you retrieve my token? | No, the token is only accessible immediately after creation. We can generate a new token for your credential by request. |
| Can we pull the episode CDN URL? | Yes, however we don't recommend this as episode CDN URLs are not static and expire within 24 hours. For audio URLs, the best practice is to retrieve the episode ID and build the enclosure URL via the format: https://rss.art19.com/episodes/EPISODE_ID.mp3
|
| Can we pull episode duration? | No, the episode's duration (without ads) is only available in the RSS feed. |
| How can I retrieve my series' image? | 1. Retrieve the cover_image id from the /series cover_image relationships object https://art19.com/series/series_id For an episode or season, the cascaded image is the series image, and cover image would be specific to the episode or season. 2. Make a reques to /images using the series’ cover_image id https://art19.com/images?cover_image_id The images have media_assets that correspond to various sizes. 3. Request the media_asset for the image. The URL for the image is the cdn_url. https://art19.com/media_assets?ids%5B%5D=media-asset-id-1&ids%5B%5D=media-asset-id-2&ids%5B%5D=media-asset-id-3 |
| Are the CDN URL intended to be embedded directly in third-party applications, or are they restricted to ART19-owned domains? | The CDN URL fields can be embedded directly in third party applications. Our CDN is designed to make direct references to the file fast. |
| Is downloading the image server-side and hosting it on our own CDN/storage the recommended approach? | This is not necessary unless they intend to transform the images. |
| Can I pull analytics via the API? | The only analytics data currently available via the API is the all time downloads for an episode (listen_count in the /episodes response). |
| Can I pull manage data for episodes on alternate feeds? | Yes, you can access all of the feeds for your series via the /feeds endpoint. And you can manage episodes on a per feed basis via the /feed_items endpoint. |