This article is for users of the Acast Create embed player. If you are unsure whether you are an Acast Create or Acast Open user, please reach out via Intercom.

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:

https://play.acast.com/s/show-id/episode-id

https://embed.acast.com/show-id/episode-id

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

Did this answer your question?