<< Back to Twitvid API Documentation

getVideos

Use this method to retrieve a list of your uploaded files

URL:

http://im.twitvid.com/api/getVideos

Formats: 

xml, json

HTTP Method:

POST

Requires Authentication:

false

Parameters:

• username: Optional. Username you request videos for
• source: Optional. An option to select videos uploaded from a specific source (web,api,mobile)
• page: Optional. The page number (starting at 1) to return
• page_size: Optional. The number of Twitvids to return per page, up to a max of 100.
• order_by: Optional. Order the results by date or view count (date,views).
• format: Optional. Select the return type (xml by default)

Usage Notes:

• If no source parameter is specified, videos from all sources will be returned. 

Response: 

          XML example:

         <?xml version='1.0' encoding='UTF-8'?>

         <rsp status='ok'>

               <status_id>1111</status_id>

               <user_id>TwitUsername</user_id>

               <page>1</page>

               <numOfVideos>2</numOfVideos>

               <order_by>date</order_by>

               <video>

                    <timestamp>2009-05-23 00:06:02</timestamp>

                    <media_id>FS34S</media_id>

                    <media_url>http://twitvid.com/FS34S</media_url>

                    <message>Awesome video!</message>

                    <source>web</source>

                    <views>2556</views>

                    <geo_latitude>57.64911</geo_latitude>

                    <geo_longitude>10.40744</geo_longitude>

               </video>

               <video>

                    <timestamp>2009-05-22 00:06:02</timestamp>

                    <media_id>445FJ</media_id>

                    <media_url>http://twitvid.com/445FJ</media_url>

                    <message>Check this video out!</message>

                    <source>web</source>

                    <views>76</views>

                    <geo_latitude>87.64911</geo_latitude >

                    <geo_longitude>50.40744</geo_longitude >                  

               </video>

          </rsp>

          JSON example:

          {"rsp":"ok",

          "status_id":"1111",

          "user_id":"TwitUsername",

          "page":"1",

          "numOfVideos":"2",

          "order_by":"date",

          "video":

                    {"0":

                         {"timestamp":"2009-05-23 00:06:02",

                         "media_id":"FS34S",

                         "media_url":"http://twitvid.com/FS34S",

                         "message":"Awesome video!",

                         "source":"web",

                         "views":"2556",

                         "geo_latitude":"57.64911",

                         "geo_longitude":"10.40744"},

                    "1":

                         {"timestamp":"2009-05-22 00:06:02",

                         "media_id":"445FJ",

                         "media_url":"http://twitvid.com/445FJ",

                         "message":"Check this video out!",

                         "source":"web",

                         "views":"76",

                         "geo_latitude":"87.64911",

                         "geo_longitude":"50.40744"}

                    }

          }

<< Back to Twitvid API Documentation