ZoomBlast API

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:

fb8ff0844aeba3d0d0c2f6fb0a55ccdf84d3

If you would like to have a method not listed here, please let us know.

Request format: REST

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

Error Responses

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.

ZoomGroups API: Video (ZoomBlast) : Video
zg.Blast.Video.Details

Returns all details from a given video ID.

Restrictions:
None.

Arguments:
method
zg.Blast.Video.Details
key
Your API Key
vId
Video ID

Example response:
<video id="1245">
   <title>This is the video title</title>
   <descr>This is the video description</descr>
   <embed>&#60;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"&#62;&#60;/embed&#62;</embed>
   <url></url>
   <thumburl>http://grouper.com/flv.ashx?id=806737&#38;rf=1&#38;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>

Specific response values:
locale:
2 letter ISO 639 Language codes (lowercase), or 'xx' if none specified
rating:
G, PG, PG13, R, NC17

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
101
Missing video ID
102
Unknown video ID

zg.Blast.Video.Comments

Returns all comments from a given video ID.

Restrictions:
None.

Arguments:
method
zg.Blast.Video.Comments
key
Your API Key
vId
Video ID

Example response:
<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>

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
101
Missing video ID
102
Unknown video ID
103
No comments have been left so far for this video

zg.Blast.Video.Tags

Returns all tags assigned to a given video ID.

Restrictions:
None.

Arguments:
method
zg.Blast.Video.Tags
key
Your API Key
vId
Video ID

Example response:
<video id="1245">
   <tags>
      <tag>funny</tag>
      <tag>vintage</tag>
      <tag>party</tag>
   </tags>
</video>

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
101
Missing video ID
102
Unknown video ID
104
No tags have been associated with this video

ZoomGroups API: Video (ZoomBlast) : General
zg.Blast.List.Top

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.

Restrictions:
None.

Arguments:
method
zg.Blast.List.Top
key
Your API Key

Example response:
<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>

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
107
No videos available
zg.Blast.List.WeeklyTop

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.

Restrictions:
None.

Arguments:
method
zg.Blast.List.WeeklyTop
key
Your API Key

Example response:
<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>

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
107
No videos available

zg.Blast.List.FrontPage

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.

Restrictions:
None.

Arguments:
method
zg.Blast.List.FrontPage
key
Your API Key

Example response:
<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>

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
107
No videos available

zg.Blast.List.Latest

Returns the last 20 submitted videos.

Hint: To get more details about a video, use zg.Blast.Video.Details on the given video IDs.

Restrictions:
None.

Arguments:
method
zg.Blast.List.Latest
key
Your API Key

Example response:
<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>

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
107
No videos available

zg.Blast.List.byTag

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.

Restrictions:
None.

Arguments:
method
zg.Blast.List.byTag
key
Your API Key
vTag
The tag to search for

Example response:
<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>

Error Codes:
1
Method missing
2
Invalid API Key
8
Daily API calls limit reached
105
Missing tag
106
Unknown tag
107
No videos available

ZoomBlast is part of the ZoomGroups network
ZoomGroups | ZoomBlogs | ZoomClouds | ZoomBlast
A service of AR Networks
Copyright © 1999-2006 AR Networks, All Rights Reserved