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

URL Scheme

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

Sample Request

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/"
    }