Skip to main content

Unshortens adf.ly, sh.st, and any 301 redirected shortener urls

Project description

Unshortens ad-based urls and 301 redirects. Supports adf.ly, lnx.lu, and sh.st.

  • Linkbucks.com and adfoc.us support temporarly removed.

Features

  • Supports unshortening the following ad-based shortners:
    • Adf.ly and related subdomains

    • Custom adf.ly domains by passing the type=’adfly’ parameter

    • Sh.st

  • Supports any 301 redirected urls

  • Python 2.7, 3.3, and 3.4 support

Usage

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(’http://ul.to’)

# 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(’http://ul.to’)

# 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(’http://ul.to’)

> 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

Installation

pip install unshortenit

History

0.1.0 (2013-10-08)

  • First release.

0.1.1 (2013-10-11)

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

0.1.2 (2013-10-11)

  • Fixed bug with t.co not working.

0.1.3 (2013-10-11)

  • Added a timeout parameter

0.1.4 (2013-10-12)

  • Added support for p.ost.im.

  • Fixed blocking issue with direct links to file downloads

0.1.6 (2014-02-01)

  • Fixed adfoc.us issues resulting from changes to their site

  • Fixed linkbucks.com issues resulting from changes to their site

0.1.7 (2014-02-03)

  • Fixed linkbucks.com issues resulting from additional changes to their site

0.1.8 (2014-02-04)

  • Fixed linkbucks.com issues resulting from additional changes to their site

0.1.9 (2014-02-08)

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

0.2.0 (2014-02-25)

  • Removed PyV8 requirement for adf.ly

  • Added ay.gy domain for adf.ly regex

  • Added sh.st support

0.2.1 (2014-05-18)

  • Removed tests for linkbucks.com and adfoc.us. Support has been temporarly removed.

  • Merged Debian Python 3.2 fix by anaconda

0.2.2 (2014-07-28)

  • Removed lnx.lu as site is out of service

0.2.3 (2015-11-13)

  • Fixed sh.st 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 anonymz.com links (provided by @guigarfr)

  • Handle href.li links (provided by @guigarfr)

  • Update user-agents (provided by @Dreysman)

0.3.1 (2017-11-26)

  • Fixed adf.ly 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.

Source Distribution

unshortenit-0.3.1.tar.gz (9.1 kB view details)

Uploaded Source

File details

Details for the file unshortenit-0.3.1.tar.gz.

File metadata

  • Download URL: unshortenit-0.3.1.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for unshortenit-0.3.1.tar.gz
Algorithm Hash digest
SHA256 9f938f68a36aff27e22074ef8be2fdc73bbb6e2d17d2e66fa6b9f755386fc330
MD5 6043a442ebb20a62d682acacbe12c89b
BLAKE2b-256 45ed2d0bd4da6b634f606aeb0a3b2bfb18d4f7f8b4835fc76be8bb3cf8eb68cb

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page