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

  • url
    string
    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

  • html
    string

    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=\"https://open.spotify.com/embed/episode/7makk4oTQel546B0PZlDM5?utm_source=oembed\"></iframe>"
  • width
    integer
    Nullable

    Width in pixels of the Embed

    Example: 456
  • height
    integer
    Nullable

    Height in pixels of the Embed

    Example: 152
  • version
    string

    Version of the oEmbed

    Example: "1.0"
  • provider_name
    string

    Provider name for the oEmbed

    Allowed values: "Spotify"Example: "Spotify"
  • provider_url
    string

    Provider URL

    Allowed values: "https://spotify.com"Example: "https://spotify.com"
  • type
    string

    Type of oEmbed

    Allowed values: "rich"Example: "rich"
  • title
    string

    Title of the item

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

    URL of a thumbnail image for the item

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

    Width of the thumbnail image

    Minimum value: 0Example: 300
  • thumbnail_height
    integer
    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=\"https://open.spotify.com/embed/episode/7makk4oTQel546B0PZlDM5?utm_source=oembed\"></iframe>",  "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}