(optional) http://x.nu/

Signing in you can create custom url like http://x.nu/alias and control traffic stats of your urls.

X.nuX.nu

- drag this icon on your browser's bar

Quality Service (No Spam)

X. NU guarantees a constant monitoring of all the short URLs. Filter out any attempt to scam, spam or phishing.

Create your
Free account

Start now!

You can use your
google account!

Api

X.NU allows developers to interact with the website via an Application Programming Interface (API). If you are planning to use X.NU to create short or customized URLs, do it for free through simple HTTP GET requests.

Introduction
Let's start with an example, maybe the best way to explain the API usage.
First of all you've to build the request URL.

http://api.x.nu/?apikey=xxx&op=cc&url=http%3A%2F%2Fwww.google.com

Please be careful: remember to url-encode all the values of the GET parameters; all the no url-encoded parameters will be ignored or misinterpreted.

The X.NU server will return a JSON formatted response:

{"result":"true","url":"http:\/\/x.nu\/aDb"}

The result field of the JSON data structure will indicate the operation outcome. In this case the requested operation was accomplished and the desired short URL is http://x.nu/aDb

Authentication
The client application has to be authenticated before the request processing. The apikey parameter represents the assigned application ID. You must send us (api@x.nu) an apikey request before you can start, explaining the purpose, the estimated requests' rate, the host name and the public IP address of the application is going to use the API.

Rate limiting
Every client application has a limited request rate per second. Additional requests will be ignored.

Request format
All the HTTP requests must be directed to http://api.x.nu with the following GET parameters:

* apikey (mandatory): the reserved client application ID.
* op (mandatory): the operation to be executed. The permitted values are cc to create short URL and ca to create customized URL. ca operation must be used together with alias parameter, see below.
* url (mandatory): the url to shorten.
* alias: the alias you want to be assigned to the specific url parameter. It will be considered only for ca operations.

Response format
The XNU application server use JSON to communicate the result of the request processing. In case of positive outcome the response will be something like this:

{"result":"true","url":"escaped-url"}

If something goes wrong, the response will contain the error message:

{"result":"false","error":"error message"}

Register your application
Request an API-key access by email.