Skip to content
Embeds •References / oEmbed API

oEmbed API

Read oEmbed data for a given entity. The base URI is https://open.spotify.com or https://spotify.link. Learn more about using Spotify's oEmbed API.

Request

  • urlstring
    Required

    The URL-encoded URL of a Spotify podcast show, episode, artist, album or track

    Example: url=https%3A%2F%2Fopen.spotify.com%2Fepisode%2F7makk4oTQel546B0PZlDM5

Response

A response containing oEmbed data

  • htmlstring

    HTML of an Embed for this item

    Example: "<iframe width=\"100%\" height=\"152\" title=\"Spotify Embed: My Path to Spotify: Women in Engineering \" style=\"border-radius: 12px\" frameborder=\"0\" allowfullscreen allow=\"autoplay; clipboard-write; encrypted-media; fullscreen; picture-in-picture\" src="/?originalUrl=https%3A%2F%2Fdeveloper.spotify.com%2F%26quot%3Bhttps%3A%2F%2Fopen.spotify.com%2Fembed%2Fepisode%2F7makk4oTQel546B0PZlDM5%3Futm_source%3Doembed%5C%26quot%3B%26gt%3B%26lt%3B%2Fiframe%26gt%3B%26quot%3B%253C%2Fcode">
  • widthinteger
    Nullable

    Width in pixels of the Embed

    Example: 456
  • heightinteger
    Nullable

    Height in pixels of the Embed

    Example: 152
  • versionstring

    Version of the oEmbed

    Example: "1.0"
  • provider_namestring

    Provider name for the oEmbed

    Allowed values: "Spotify"Example: "Spotify"
  • provider_urlstring

    Provider URL

    Allowed values: "https://spotify.com"Example: "https://spotify.com"
  • typestring

    Type of oEmbed

    Allowed values: "rich"Example: "rich"
  • titlestring

    Title of the item

    Example: "My Path to Spotify: Women in Engineering"
  • thumbnail_urlstring
    Nullable

    URL of a thumbnail image for the item

    Example: "https://i.scdn.co/image/ab67656300005f1ff8141e891abf749375772343"
  • thumbnail_widthinteger
    Nullable

    Width of the thumbnail image

    Minimum value: 0Example: 300
  • thumbnail_heightinteger
    Nullable

    Height of the thumbnail image

    Minimum value: 0Example: 300
endpointhttps://open.spotify.com/oembedurl

Response sample

{  "html": "<iframe width=\"100%\" height=\"152\" title=\"Spotify Embed: My Path to Spotify: Women in Engineering \" style=\"border-radius: 12px\" frameborder=\"0\" allowfullscreen allow=\"autoplay; clipboard-write; encrypted-media; fullscreen; picture-in-picture\" src="/?originalUrl=https%3A%2F%2Fdeveloper.spotify.com%2F%26quot%3Bhttps%3A%2F%2Fopen.spotify.com%2Fembed%2Fepisode%2F7makk4oTQel546B0PZlDM5%3Futm_source%3Doembed%5C%26quot%3B%26gt%3B%26lt%3B%2Fiframe%26gt%3B%253C%2Fspan">",  "width": 456,  "height": 152,  "version": "1.0",  "provider_name": "Spotify",  "provider_url": "https://spotify.com",  "type": "rich",  "title": "My Path to Spotify: Women in Engineering",  "thumbnail_url": "https://i.scdn.co/image/ab67656300005f1ff8141e891abf749375772343",  "thumbnail_width": 300,  "thumbnail_height": 300}