oEmbed

oEmbed is an open standard designed to allow embedding image or video content into websites. The simple API allows a website to display embedded content (such as photos or videos) when a user posts a link to that resource, without having to parse the resource directly.

Endpoint

https://api.smugmug.com/services/oembed/

URL Scheme

https://*.smugmug.com/\* (https://\*.smugmug.com/\*)
http://*.example.com/\* (http://\*.example.com/\*) where example.com is a SmugMug customer's domain

Discovery

Most SmugMug URLs support discovery using tags in the document header as described in the oEmbed spec.

Notes

Many SmugMug URLs contain fragments (example: #1234_abcd) To ensure the proper oEmbed profile is returned, please include the full fragment when doing discovery or requesting embeds details.

Due to differences in available metadata (example: a photo may not have a title), some fields may or may not be present in the embeds data.

Arguments

url (required)
The URL to retrieve embedding information for.
Note: This parameter should be URL encoded.
callback
A JSONP callback function to be executed on the client side.
format
The required response format.
- json
- xml (default)
maxheight
The maximum height of the embedded resource.
maxwidth
The maximum width of the embedded resource.

Sample Request

https://api.smugmug.com/services/oembed/?url=https://www.smugmug.com/popular/all%23125787395_hQSj9

Sample Responses

{
      "version": "1.0",
      "provider_name": "SmugMug",
      "provider_url": "https://www.smugmug.com/",
      "type": "photo",
      "title": "Great Egret at dusk",
      "height": "400",
      "width": "600",
      "url": "http://www.jlvaillant.com/Animals/Birds/Egrets-Herons/Bird-000132-Version-3/125787395_hQSj9-M-3.jpg",
      "author_name": "Jean-Luc Vaillant",
      "author_url": "http://www.jlvaillant.com/"
    }