{shortcut} also opens this dialog box">

spacer oEmbed

{0}."> {0}-{1} of {2} pages containing {3}.">
Skip to end of metadata
  • Page restrictions apply
  • Added by David Parry, last edited by Don MacAskill on Jun 12, 2011  (view change)
Go to start of metadata

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.


  • api.smugmug.com/services/oembed/

URL Scheme

  • *.smugmug.com/*
  • http//*.example.com/* where example.com is a SmugMug customer's domain


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


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


  • url (required)
    The URL to retrieve embedding information for.
    Note: This parameter is should to 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

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

Sample Responses

  • JSON
  • XML
  "version": "1.0",
  "provider_name": "SmugMug",
  "provider_url": "www.smugmug.com/",
  "type": "photo",
  "title": "Great Egret at dusk",
  "height": "400",
  "width": "600",
  "url": "www.jlvaillant.com/Animals/Birds/Egrets-Herons/Bird-000132-Version-3/125787395_hQSj9-M-3.jpg",
  "author_name": "Jean-Luc Vaillant",
  "author_url": "www.jlvaillant.com/"
Labels parameters
Enter labels to add to this page:
Looking for a label? Just start typing.
gipoco.com is neither affiliated with the authors of this page nor responsible for its contents. This is a safe-cache copy of the original web site.