API

Features

• Generate or get existing short URLs, with sequential or custom keyword
• Get some statistics about your links: top clicked links, least clicked links, newest links
• Output format: JSON, XML, or simple raw text
• Authentify either with login/password or using a secure passwordless mechanism

Usage

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

• The requested action: "shorturl" (get short URL for a link), "expand" (get long URL of a shorturl), "url-stats" (get stats about one short URL) or "stats" (get stats about your links)
• With action = "shorturl" :
  • the url to shorten
  • optional keyword for custom short URLs
  • output format: either "json", "xml" or "simple"
• With action = "expand" :
  • the shorturl to expand (can be either 'abc' or 'http://site/abc')
  • output format: either "json", "xml" or "simple"
• With action = "url-stats" :
  • the shorturl for which to get stats (can be either 'abc' or 'http://site/abc')
  • output format: either "json" or "xml"
• With action = "stats" :
  • the filter: either "top", "bottom" , "rand" or "last"
  • the limit (maximum number of links to return)
  • output format: either "json" or "xml"

Sample return

<result>
	<url>
		<id>62019439011</id>

		<keyword>shorter</keyword>
		<url>http://somereallylongurlyouneedtoshrink.com/</url>
		<date>2009-06-23 18:08:07</date>
		<ip>127.0.0.1</ip>

	</url>
	<status>success</status>
	<message>http://somereallylongurlyouneedtoshrink.com/ (ID: shorter) added to database</message>
	<shorturl>http://yoursite.com/shorter</shorturl>

</result>