expandurl™ API

The expandurl™ API provides free programmatic access for web developers who need to determine the final redirected endpoint for any URL.

This is useful to expand short urls and can be helpful in maintaining accurate link data from third party services which employ redirected tracking URLs.

REST endpoint URL

All requests should use the HTTP GET protocol with this URL:

http://expandurl.com/api/v1/

basic request format

For most uses, simply returning the expanded or redirected URL should be sufficient. Such requests should look like:

http://expandurl.com/api/v1/?url=http://www.expandurl.com/

If the provided URL redirects, this request returns the final string URL. If the provided URL does not redirect, it will return the provided URL. In the case of an error, this will return the text string "false" and a 404 status code.

detailed request format

Requests for additional URL and redirect data (similar to what is available in the typical web interface) is available by specifying your request like so:

http://expandurl.com/api/v1/?url=http://www.expandurl.com/&format=json&detailed=true

Available formats include json and php (which returns a serialized array).

request limiting

Users are limited to 100 requests/hour. If you exceed this limit, requests will receive a 403 Forbidden status code.

terms of use

API usage is bound to the same Terms of Service as the rest of the site.

3,137,902 URLs expanded      All rights reserved. © 2009 - 2017 Gregg Hilferding      Terms of Service  |  API