This Application Programming Interface (API) has been created to help web developers and programmers benefit from Simple URL with it's resources. Using the API url listed below, it will return the hash of the newly created Simple URL. As with the site itself, the API also supports the use of the Ident feature. The Ident is optional, leave out if you wish to not use it.

Format: Plain Text

API URL: http://simurl.us/api.php?url=[URL]&ident=[IDENT]
Return: Plain text of 5 character hash. such as "cu2Dg"


Format: JSON

API URL: http://simurl.us/api.php?url=[URL]&ident=[IDENT]&format=json
Return: Javascript Object with elements:

• hash: Hash given to this newly created Simple URL.
• ident: The Ident you used, if any.
• orig_url: The original URL given to us, and possible formated by the system. (i.e. prepending the 'http://' if missing)
• simurl: The Simple URL Address Link.
• preview: The Simple URL Preview Address Link.

Note: Please be sure to URL Encode the URL using the PHP function urlencode or a url encode function similar. This is used to help maintain the integrity of the URL.

Example: http://simurl.us/api.php?url=http://simurl.us will return the plain text hash of "oqzpQ".