Content Metadata and Discovery

Image Full View pages and Search Result Detail pages provide HTML tags that describe the image represented by the page. Browser apps, bookmarklets, and tools that follow links may use these HTML tags to programmatically gather thumbnail, title, description, and dimension information. The URLs look similar to:

Image Full View:

http://s123.photobucket.com/albums/v214/pbapi/?action=view&current=file.jpg

Search Result Detail:

http://media.photobucket.com/image/searchterm/pbapi/file.jpg

Meta and Link Tags

Photobucket implements the generally accepted set of tags, used by many of the social networking and news sites, such as:

Available Tags

Title and owner of media:

<meta name="title" content="text" />

User description of media:

<meta name="description" content="text" />

Thumbnail of media:

<link rel="image_src" href=http://i123.photobucket.com/albums/v214/th_file.jpg />

Medium type of media (image or video):

<meta name="medium" content="image" />

For Videos

<link rel="video_src" href="http://..." />

<meta name="video_height" content="" />

<meta name="video_width" content="" />

<meta name="video_type" content="" />

oEmbed

Photobucket implements oEmbed http://oembed.com/ for media.

Configuration

URL scheme:

http://i*.photobucket.com/albums/*

http://gi*.photobucket.com/groups/*

API Endpoint: http://photobucket.com/oembed

The API endpoint exists on all 's' subdomains as well, and redirects to the appropriate 's' for the media. Clients should be able to follow the redirects.

Response

Photobucket supports: xml, json, and jsonp (as jsonp or json, requiring specification of a 'callback' parameter)

Discovery

Photobucket implements the <link rel="alternate"...> tags for the same pages as the Meta and Link Tags above.

Available Tags

<link rel="alternate" type="application/json+oembed" href="http://photobucket.com/oembed?url=http://i123.photobucket.com/albums/v214/file.jpg&format=json" title="title oEmbed Profile" />

<link rel="alternate" type="text/xml+oembed" href="http://photobucket.com/oembed?url=http://i123.photobucket.com/albums/v214/file.jpg&format=xml" title="title oEmbed Profile" />