ExpandURL

Please enable javascript.


Loading...

To start, enter a short url and hit Expand!

redirects to

    Powered by Google App Engine

    ExpandURL is aimed at being a simple, fast and flawless URL expander. For example, it supports those fancy tinyarrows URLs. In fact, it should support all short urls using the location header to redirect.

    Please note: ExpandURL is hosted on a free Google App Engine plan. I do not have the ability to pay for it and keep it from going over capacity. If you are interested in hosting your own instance, the source code is available on GitHub.

    ExpandURL provides a simple but useful API for expanding URL's.

    Request

    Requests are sent to the API endpoint with the arguments using either POST or GET.

    API endpoint:

    http://expandurl.appspot.com/expand

    POST/GET arguments:


    Response

    Responses are JSON objects with the following items:

    Note: even if an error occurs, all of these are present, even if start_url equals end_url, redirects is 0 and urls contain only the input url.

    Another note: "InvalidURL" may simply denote that the url redirected to doesn't work, because of an old shortened url etc.


    Examples

    Input URL:
    http://bit.ly/jcelX0
    Request:
    http://expandurl.appspot.com/expand?url=http%3A%2F%2Fbit.ly%2FjcelX0
    Response:
    {
    "status": "OK",
    "end_url": "http://expandurl.appspot.com",
    "redirects": 1,
    "urls": [
    	"http://goo.gl/u6U1n0",
    	"http://expandurl.appspot.com"
    ],
    "start_url": "http://bit.ly/jcelX0"
    }
    Input URL:
    this is not a valid url
    Request:
    http://expandurl.appspot.com/expand?url=this%20is%20not%20a%20valid%20url
    Response:
    {
    "status": "InvalidURL",
    "end_url": "http://this is not a valid url",
    "redirects": 0,
    "urls": [
    	"http://this is not a valid url"
    ],
    "start_url": "http://this is not a valid url"
    }