Developer Center

Need a Hand?

Developer Center

Content

Overview

Resources in content will return a <feed> containing one or more <entry> elements describing content items, or an empty <feed> if no results matching your criteria can be found. A content item is generally a video, although images and other multimedia files are also handled by Magnify.

Resources

show

parameters

• id (required)

example

Returns an entry describing the content item specified by the id. The id parameter is a 16-digit alphanumeric string, as elsewhere. You can obtain the id from the find results below, any kind of entry referencing a content or the URI of the items's Magnify page.

browse

parameters

• page (default: 1)
• per_page (default: 10)
• sort (default: recent)
• iframe_width (default: 300)

example

Retrieves all items from the channel in the specified sort order. Returns pages of results conaining appropriate <media:content> tags for embedding, see below. The iframe_* parameters control the dimensions of the iframe thus generated. Valid sort modes are recent, title and rating.

find

parameters

• vq (required)
• page (default: 1)
• per_page (default: 10)
• sort (default: recent)
• iframe_width (default: 300)

example

Searches the channel's contents in the same way as the normal channel search. The optional parameters are exactly the same as for browse above.

user

parameters

• id (required)
• page (default: 1)
• per_page (default: 10)
• sort (default: recent)
• iframe_width (default: 300)

example

Retrieves a list of content items owned by the user specified by the id parameter. The optional parameters are the same as for browse above.

Results

Feed Format

A standard feed with openseach metadata is produced, as described on the Feed page.

Entry Format

<entry>
  <link rel="self"
        href="http://example.magnify.net/api/content/show?id=G2CZ4LW96RGTZ3Q8" />
  <link rel="alternate"
        href="http://example.magnify.net/video/Buddy-Can-You-Spare-a-Million" />
  <link rel="user"
        href="http://example.magnify.net/api/user/show?id=YH65RWKLY4FGYQYW" />
  <author>
    <name>example</name>

    <uri>http://example.magnify.net/api/user/show?id=YH65RWKLY4FGYQYW</uri>
  </author>
  <magnify:id>G2CZ4LW96RGTZ3Q8</magnify:id>
  <updated>2008-08-04T09:40:13Z</updated>
  <title>Buddy, Can You Spare a Million?</title>
  <id>http://example.magnify.net/api/content/show?id=G2CZ4LW96RGTZ3Q8</id>

  <content>Whose million dollars is it, when Gabe lends Barbarino a quarter for Barbarino's share in a lottery ticket?</content>
  <media:thumbnail url="http://thumbnails.truveo.com/0005/5A/67/5A672C6E13C2E2CE1858D1.jpg" />
  <media:content width="300"
                 medium="video"
                 url="http://example.magnify.net/embed/content/G2CZ4LW96RGTZ3Q8/FFFFFF/w300"
                 duration="1499"
                 type="text/html"
                 height="360" />
</entry>

Important Elements

• link: links to relevant resources
  • self: a feed containing only this entry (useful for getting individual entries from find results)
  • alternate: the Magnify-hosted page for this content item
  • user: a feed representing the user to whom this content belongs, present if the user is not Anonymous
• author: description of the user associated with this content items
  • name: the user's magnify handle or full name (whichever is available)
  • uri: a link to the feed representing the user (same as link rel=user above)
• title, content: the title and description of the content item
• media:thumbnail: the location of the thumbnail for this content item, given as the url attribute
• media:content: the embeddable iframe player for the content item
  • url: the URI of the iframe source, see the Developer's Guide for more informaiton on how to embed this in your page
  • width, height: the dimensions of the player (can be overriden)
  • duration: duration of the media in seconds
  • type: the type of the player object (currently always text/html meaning iframe)
• magnify:id: the content item's id number; valid for id=... parameters
• id: Atom-required entry id

Note

Feeds returned from content resources are 100% valid Atom!