<< Back to Twitvid API Documentation

 

getVideos

Use this method to retrieve a list of your uploaded videos

 

URL:

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

 

Formats: 

xml, json

 

HTTP Method:

POST

 

Requires Authentication:

true

 

Parameters:

If passing in credentials, you must supply twitter username and password. You can not pass token if passing in credentials:

{

• username: Required. Your Twitter username.
• password: Requred. Your Twitter password.

}

else If passing in Authentication Token from authenticate, you can not pass the username and password:

{

• token: Required. The Authentication Token

}

• 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:

• Either pass Twitter username and password, or pass token from authenticate. These are required for authentication.
• 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