API documentation

Video ยป GET

Retrieve information about an upload.

Arguments

None

Request example

cURL

curl http://heyspread.com/api2/video/555

Ruby

HeySpread::Video.find(555)

PHP

HeySpread_Video::find(555)

Response example

<video>
  <id>555</id>
  <title>testing</title>
  <description>test</description>
  <category>Auto & vehicles</category>
  <tags>test tag</tags>
  <created-at>Wed May 07 18:34:09 +0200 2008</created-at>
  <updated-at>Fri May 09 19:07:29 +0200 2008</updated-at>
  <status>uploading</status>
  <stat>false</stat>
  <uploads>
    <upload site="google" time-left="00:01:14" percent="50" transferred="3400" total="6800" speed="121" />
  </uploads>
  <links>
    <link site="revver">http://one.revver.com/watch/869766</link>
    <link site="putfile">http://media.putfile.com/testing16</link>
    <link site="crackle">http://crackle.com/#id=2274513</link>
    <link site="veoh">http://www.veoh.com/videos/v1593683rt65588A</link>
    <link site="flurl">http://www.flurl.com/item/testing16_u_324504</link>
    <link site="vsocial">http://www.vsocial.com/video/?d=223423</link>
    <link site="youtube">http://youtube.com/watch?v=Sz6Ys04j-3Y</link>
    <link site="dailymotion">http://www.dailymotion.com/video/x5cadv_10a439d1ed6c66f82cb8d4fa683e835d</link>
    <link site="sumo">http://www.sumo.tv/video/3604759</link>
    <link site="yahoo">http://video.yahoo.com/watch/2628586</link>
    <link site="blip">http://blip.tv/file/885986</link>
    <link site="myspace">http://vids.myspace.com/index.cfm?fuseaction=vids.individual&videoid=2109530038</link>
    <link site="vimeo">http://www.vimeo.com/986325</link>
    <link site="photobucket">http://s194.photobucket.com/albums/z52/fenril_bucket/?action=view&current=10a439d1ed6c66f82cb8d4fa683e835d.flv</link>
    <link site="viddler">http://www.viddler.com/explore/fenril/videos/41</link>
    <link site="facebook">http://www.facebook.com/video/video.php?v=0141761733025697273</link>
  </links>
  <errors>
    <error site="metacafe">Video already uploaded, duplicate error</error>
  </errors>
</video>

Explanations

  • <status> can be "pending" (the video is not processing yet), "downloading" (the video is being downloaded), "encoding" (the video is being encoded / watermarked), "uploading" (the video is being uploaded to all the destinations), "finished" (all is done, the video is successfully uploaded)
  • <stat> can be true or false. To enable the statistics for this video, see PUT /spread
  • <uploads> represents the active uploads with interesting information like speed, progression and time left.
  • <links> represents the valid links for each sites.
  • <errors> represents the failed uploads with error message.