link-shorteners Package

This package exposes a list of all known link shorteners (also known as URL shorteners). This can help you block or filter link shorteners. We are promoting responsible link shortening practices and trying to cut down on spam. Built by Maya from y.gy.

Latest Version: 1.10.0 released on 2024-Mar-8

Table of Contents

• Key Features
• Installation
• Usage
• Contribution
• License
• Motivation

Key Features

Efficiently Block URL Shorteners

Empower your website's security by using the link-shorteners package to have access to a frequently-updated list of link shorteners. Use the list to efficiently block, filter, or review well-known URL shorteners such as bitly, t.co, ow.ly, tinyurl, shorturl and more. Protect your website from re-linking spam or potential security risks.

Extremely Helpful for Link Shortening Platforms

This list empowers link shortening platforms to effectively restrict the usage of previously shortened links as replacements for destination URLs. This avoids chain shortening/unauditable re-linking, enhances security, prevents spam and enforce quality control.

Open Source

link-shorteners package is open source, allowing developers (you!) to contribute and keep our list of link shorteners up-to-date.

Installation

You can install the link-shorteners package using npm. Open your terminal and run the following command:

npm install link-shorteners

Make sure that you are always upgrading to the latest version of link-shorteners so your list of link shorteners is up-to-date!

Usage

const linkShorteners = require("link-shorteners");

bannedShorteners = linkShorteners.listLinkShorterners();

urlToCheck = "https://bit.ly/abc123"

if (bannedShorteners.some(shortener => urlToCheck.toLowerCase().includes(shortener))) {
    console.log("The URL is blocked");
}

Contribution

The source code is open sourced and is currently hosted on GitHub at: https://github.com/mayakyler/link-shorteners

We welcome contributions from the community to enhance and expand the list of link shorteners. Feel free to submit issues or pull requests to add more link shorteners, ensuring that the package remains up-to-date and comprehensive.

IMPORTANT: When updating a list of shorteners, make sure to update the .txt file in both the npm package and pypi package to ensure consistency.

License

MIT

Motivation

Our motivation behind developing this package stems from our experience building y.gy, a link shortening platform. Facing challenges such as spam from various link-shortening platforms, we created this list to empower developers and platforms to efficiently block unwanted links in destination URLs. By utilizing this package, you can enhance the security and integrity of your platform, making it a safer space for users.