x

oEmbed

oEmbed is a format for allowing an embedded representation of a URL on third party sites. It is a popular standard adopted by sites such as WordPress and Tumblr to embed content from other websites.

ReverbNation currently supports oEmbed for our artist profile pages, and song pages. The ReverbNation oEmbed endpoint serves up an embed code for the ReverbNation Player Widget.

Endpoint

The ReverbNation oEmbed endpoint is located at

https://www.reverbnation.com/oembed?url=

It accepts any URL pointing to an artist or song and supports XML and JSON as a response format.

Example:

https://www.reverbnation.com/oembed?url=https%3A%2F%2Fwww.reverbnation.com%2Fscottyandthereverbs

which returns something like:

<oembed> <version>1.1</version> <type>rich</type> <provider-name>ReverbNation</provider-name> <provider-url>https://www.reverbnation.com</provider-url> <width>100%</width> <height type="integer">500</height> <title>Scotty and the Reverbs</title> <description> Electronica music, lyrics, and videos from Durham, NC on ReverbNation </description> <html> <iframe width="100%" height="500" scrolling="no" frameborder="no" src="https://www.reverbnation.com/widget_code/html_widget/149?widget_id=55&pwc[included_songs]=1"></iframe> </html> <author-name>Scotty and the Reverbs</author-name> <author-url>https://www.reverbnation.com/scottyandthereverbs</author-url> <thumbnail-url> https://gp1.wac.edgecastcdn.net/802892/production_public/Artist/149/image/70114826-5F1F-44FA-8CFF-0A394DD39538-532-000000AE6D09B017.jpg </thumbnail-url> </oembed>

Parameters

Name Default Description
url - A ReverbNation URL for an artist or song.
format xml (optional) Either xml or json.
maxheight 500 The maximum height of the embedded resource.
maxwidth 100% The maximum width of the embedded resource.