mv2.me API

Features

* Generate shortened URLs, with sequential keyword
* Augment shortened URLs with embedded geodata and calendar data
* Output format: XML or simple raw text
* Custom shortened URLS are not supported by the API.

Usage

You need to send parameters to http://mv2.me/public-api.php either via GET or POST.
These parameters are:

* The requested action: either "shorturl" (get short URL for a link) or
"expand" (get information about the shortened link)

* With action = "shorturl" :
	o url - the url to shorten
	o keyword - optional keyword for custom short URLs
	o format - output format: either "xml" or "simple"
	
	the following parameters are optional :
	o latitude
	o longitude
	o event_date - can be either unix timestamp or YYYY-MM-DD%20HH:MM:SS (note url-escaped space)
	o recurring - either "daily", "weekly" or "none" (if omitted, set to "none")
	o end_date - date to end on, unix timestamp format or YYYY-MM-DD%20HH:MM:SS

	eg http://mv2.me/public-api.php?action=shorturl&url=http://www.url.com&format=xml
	   http://mv2.me/public-api.php?action=shorturl&url=http://www.url2place.com&format=xml&latitude=41.6756956&longitude=-71.553395
	   http://mv2.me/public-api.php?action=shorturl&url=http://www.url2event.com&format=xml&event_date=2010-12-25%20:30:00&recurring=false
	   
	successful shortening will occur as long as the url to shorten is valid, even if the latitude and longitude or dates and recurrence are invalid.
	the extra meta-data will simply not be added to the database
	if you want the shortening to fail unless all parameters are accepted, include the following parameter :
	o strict - "true"
	   
* If you wish to add mv2.me expanding functionality to your web service, you can use action = "expand" 
	o shorturl - can be either 'abc' or 'http://mv2.me/abc'
	o format - 'xml' or 'simple' (default)
	
	eg http://mv2.me/public-api.php?action=expand&shorturl=abc&format=xml

The xml format will return all currently exposed metadata, as such: 
<result>
  <keyword>oblib</keyword> 
  <shorturl>http://mv2.me/oblib</shorturl>
  <longgurl>http://oakbluffslibrary.org/</longurl>
  <location>POINT(-70.5671539932182 41.4553854745661)</location> 
  <calendar>
  	<event_date>2010-08-31 14:30:00</event_date> 
  	<recurrence>weekly</recurrence> 
  	<last_date>2010-10-01 00:00:00</last_date> 
  </calendar>
  <media>
  	<media_type>image</media_type>
  	<mime_type>image/jpg</mime_type>
  	<thumbnail>http://s3.mv2.me/small/33367205/oblib.jpg</thumbnail>
  	<small>http://s3.mv2.me/medium/33367205/oblib.jpg</small>
  	<large>http://s3.mv2.me/large/33367205/oblib.jpg</large>
  	<views>1000</views>
  	<keywords>library</keywords>
  </media>
  <user>
  	<twitter_id>33367205</twitter_id>
  	<screen_name>mvtweets</screen_name>
  	<name>mv tweets</name>
  	<profile_image>https://si0.twimg.com/profile_images/1157290442/mvtweets_large_normal.png</profile_image>
  </user>
  <message>success</message>
  <statusCode>200</statusCode>
</result>

Drop us a line if you have any questions or suggestions: api AT mv2.me

Use of the mv2.me API, as with the rest of the mv2.me service, is provided
"as is" at your own risk with no warranties implied. We make no
guarantees as to the availability of the service at any time.

But we'll try damn hard to always be there for you.