ART19 offers access to the API for any network or series owners. In order to access the API, please write support@art19.com to request a token and credentials. These are required for API pulls. If you are not an owner in the network or series, feel free to CC a contact from the account for approval. We also encourage you to tell us a bit about how you would like to use the API, so we can make sure it will suit your needs.
Here is documentation on how to use our API: https://art19.com/developers
What can the API do?
The API only allows you to pull data from ART19, not make edits or changes to any profiles.
You can:
- Pull series and episode details from the Content API
- Build an embeddable player from our Player API
You can't:
- Pull stats
- Pull any Ad Ops content
- Input any changes to profiles on ART19
We offer limited support when it comes to player customizations via the API on external sites, but here are some FAQs that may be helpful:
| Question | Solution |
| API call not working? | Please send support@art19.com the full pull request or cURL. |
| Can I get more info about how to use your API? | https://art19.com/developers |
| Can you retrieve my token? | No, we would have to create new credentials. The token is only visible to us when creating the credential. The customer should then save the token somewhere safe. |
| Can we pull the episode CDN URL? | No, we don't recommend this as episode CDN URLs are not static. They have validations that expire. For audio URLs, pull 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, you can retrieve the duration without adjustment for dynamic insertion from the RSS feed |
| How can I pull series image? | 1. Request series/episode cover_image_id or cascaded_cover_image_id https://art19.com/episodes?series_id=series_id&fields%5Bepisode%5D=cover_image_id,cascaded_cover_image_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. Request images via 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 |
| Can I pull stats via the API? |
No, at this time, the API is only used for pulling content information from networks and series, as well as building embed players. |
| Can I pull data from alternate feeds? |
Yes, reach out to support@art19.com for assistance! |