Skip to main content

Unshortens,, and any 301 redirected shortener urls

Project description

Unshortens ad-based urls and 301 redirects. Supports,, and

  • and support temporarly removed.


  • Supports unshortening the following ad-based shortners:
    • and related subdomains
    • Custom domains by passing the type=’adfly’ parameter
  • Supports any 301 redirected urls
  • Python 2.7, 3.3, and 3.4 support


import unshortenit

# Unshorten known ad urls. # This call will not generate any HTTP requests unless the passed # URL is a known ad/shortening link, and the library knows how to # unshortedn said link. unshortened_uri, status = unshortenit.unshorten_only(’’)

# Unwrap any HTTP 30x redirects (if present). This will always issue a HTTP # HEAD request, even if there is not a 30x redirect on the passed link # (you cannot tell if a redirect is present without making a request). unshortened_uri, status = unshortenit.unwrap_30x_only(’’)

# Unshorten any ad content, and unwrap any HTTP 30x redirects (if present). # Internally, this basically calls unshorten_only(), and then unwrap_30x_only() # sequentially on the passed URL, returning early if the unshorten_only() # call returned an error. unshortened_uri, status = unshortenit.unshorten(’’)

> All calls will return a tuple (unshortened_uri, status)

> unshortened_uri will contain the unshortened uri. If you pass in a non-shortener url it will return the original url. > status will contain the status code or any error messages


pip install unshortenit


0.1.0 (2013-10-08)

  • First release.

0.1.1 (2013-10-11)

  • Added support for custom domains via the type=’adfly’ variable.

0.1.2 (2013-10-11)

  • Fixed bug with not working.

0.1.3 (2013-10-11)

  • Added a timeout parameter

0.1.4 (2013-10-12)

  • Added support for
  • Fixed blocking issue with direct links to file downloads

0.1.6 (2014-02-01)

  • Fixed issues resulting from changes to their site
  • Fixed issues resulting from changes to their site

0.1.7 (2014-02-03)

  • Fixed issues resulting from additional changes to their site

0.1.8 (2014-02-04)

  • Fixed issues resulting from additional changes to their site

0.1.9 (2014-02-08)

  • Switched to use selenium PhantomJS driver due to ongoing challenges with their site

0.2.0 (2014-02-25)

  • Removed PyV8 requirement for
  • Added domain for regex
  • Added support

0.2.1 (2014-05-18)

  • Removed tests for and Support has been temporarly removed.
  • Merged Debian Python 3.2 fix by anaconda

0.2.2 (2014-07-28)

  • Removed as site is out of service

0.2.3 (2015-11-13)

  • Fixed support

0.3.0 (2016-05-20)

  • Split out unshortening and unwrapping 301 redirects into separate calls.
  • Added support for unwrapping google proxy links.
  • Some general cleanup in tests, updated some of the test links.
  • Handle links (provided by @guigarfr)
  • Handle links (provided by @guigarfr)
  • Update user-agents (provided by @Dreysman)

0.3.1 (2017-11-26)

  • Fixed decoding issues (provided by @marlowww)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for unshortenit, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size unshortenit-0.3.1.tar.gz (9.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page