oEmbed is an open standard for allowing an embedded representation of a URL on third party sites. The oEmbed endpoint will serve the embed code for the Acast Embed Player.
To request the embed code for an episode from its URL, you can use the following endpoint:
https://oembed.acast.com/v1/embed-player
Example:
https://oembed.acast.com/v1/embed-player?url=https%3A%2F%2Fplay.acast.com%2Fs%2Fgo-off-sis%2Fkeepthatsameenergyfeat.kekepalmer
Parameters:
Field | Description |
url (required) | Encoded URL to the episode. Supported URLs: embed.acast.com and play.acast.com
Example: |
width or maxwidth (optional) | Define the Embed Player iframe width attribute. By default the width is 100% |
height or maxheight (optional) | Define the Embed Player iframe height attribute. By default the height is 180px |
Response
Field | Type | Description |
version | String | oEmbed spec version. Value: 1.0 |
type | String | The resource type. Value: rich |
provider_name | String | Value: Acas |
provider_url | String | Value: https://embed.acast.com |
title | String | The episode's title |
description | String | The episode's description containing HTML tags |
summary | String | The episode's description without HTML tags |
width | Int | The player's width |
height | Int | The player's height |
thumbnail_url | String | The episode's cover image |
thumbnail_width | String | The episode's cover image width |
thumbnail_height | String | The episode's cover image height |
html | String | The HTML required to display the Embed Player |