We're happy to offer this API to the developer community so that you can extend the use of ZoomBlast into your own sites and applications.
We're also working on a major API development not just for ZoomBlast but for all of our ZoomGroups services: Email groups, blogs, social networking, marketplace, etc. that we expect to launch along with a major redesign of the entire ZoomGroups platform, so stay tuned!
Right now, and until we release the complete ZoomGroups API, we're only offering an experimental and basic set of read-only APIs for ZoomBlast,
An API Key is required for all API calls, but during this experimental phase, no API keys are assigned to individual users. The only working API key at this moment (and the one you should use for now) is:
If you would like to have a method not listed here, please let us know.
We've selected the REST format because it is the simplest format and can be used with a simple HTTP GET or POST action.
The REST endpoint URL for the ZoomBlast API is http://www.zoomblast.com/API
For example, to call the zg.Blast.Video.Details method, you will invoke it like this:
http://www.zoomblast.com/API?method=zg.Blast.Video.Details&key=fb8ff0844aeba3d0d0c2f6fb0a55ccdf84d3&vId=45
In the event of an error, you'll receive an XML document as follows:
<?xml version="1.0" encoding="utf-8" ?> <rsp stat="fail"> <err code="2" msg="Invalid API Key" /> </rsp>
Of course, the error code and the message will be different, depending on what went wrong.
Returns all details from a given video ID.
<video id="1245"> <title>This is the video title</title> <descr>This is the video description</descr> <embed><embed allowScriptAccess="never" src="http://grouper.com/mtg/mtgPlayer.swf?v=0.1" width=321 height=265 quality="high" scale="noScale" wmode="transparent" pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash" type="application/x-shockwave-flash"></embed></embed> <url></url> <thumburl>http://grouper.com/flv.ashx?id=806737&rf=1&vfver=8</thumburl> <permalink>http://www.zoomblast.com/vblast/vId=1245</permalink> <uptime>1127675320</uptime> <!-- UNIX time, seconds since 1/1/70 --> <locale>en</locale> <score>412</score> <category></category> <!-- Not used yet --> <comments>2</comments> <rating>PG13</rating> </video>
Returns all comments from a given video ID.
<video id="1245"> <comments> <comment> <author>RBA</author> <text>This is my comment</text> <time>1128356789</time> </comment> <comment> <author>Pete</author> <text>Blah blah blah</text> <time>1128359871</time> </comment> </comments> </video>
Returns all tags assigned to a given video ID.
<video id="1245"> <tags> <tag>funny</tag> <tag>vintage</tag> <tag>party</tag> </tags> </video>
Returns the top 20 videos of all time.
Hint: To get more details about a video, use zg.Blast.Video.Details on the given video IDs.
<videos> <video id="45"> <title>This is the video title</title> <permalink>http://www.zoomblast.com/vblast/vId=45</permalink> <score>412</score> </video> <video id="221"> <title>Best video ever</title> <permalink>http://www.zoomblast.com/vblast/vId=221</permalink> <score>22</score> </video> ...up to 20 videos... </videos>
Returns the top 20 videos in the last 7 days.
Hint: To get more details about a video, use zg.Blast.Video.Details on the given video IDs.
<videos> <video id="45"> <title>This is the video title</title> <permalink>http://www.zoomblast.com/vblast/vId=45</permalink> <score>412</score> </video> <video id="221"> <title>Best video ever</title> <permalink>http://www.zoomblast.com/vblast/vId=221</permalink> <score>22</score> </video> ...up to 20 videos... </videos>
Returns the first 20 videos from the current Front Page.
Hint: To get more details about a video, use zg.Blast.Video.Details on the given video IDs.
<videos> <video id="45"> <title>This is the video title</title> <permalink>http://www.zoomblast.com/vblast/vId=45</permalink> <score>412</score> </video> <video id="221"> <title>Best video ever</title> <permalink>http://www.zoomblast.com/vblast/vId=221</permalink> <score>22</score> </video> ...up to 20 videos... </videos>
Returns the last 20 submitted videos.
Hint: To get more details about a video, use zg.Blast.Video.Details on the given video IDs.
<videos> <video id="45"> <title>This is the video title</title> <permalink>http://www.zoomblast.com/vblast/vId=45</permalink> <score>412</score> </video> <video id="221"> <title>Best video ever</title> <permalink>http://www.zoomblast.com/vblast/vId=221</permalink> <score>22</score> </video> ...up to 20 videos... </videos>
Returns the last 20 submitted videos assigned a given tag.
Hint: To get more details about a video, use zg.Blast.Video.Details on the given video IDs.
<videos> <video id="45"> <title>This is the video title</title> <permalink>http://www.zoomblast.com/vblast/vId=45</permalink> <score>412</score> </video> <video id="221"> <title>Best video ever</title> <permalink>http://www.zoomblast.com/vblast/vId=221</permalink> <score>22</score> </video> ...up to 20 videos... </videos>