Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rubiin/url-minify

Js library to shorten urls
https://github.com/rubiin/url-minify

nodejs npm shortner shortnerurl url url-shortener

Last synced: 2 months ago
JSON representation

Js library to shorten urls

Awesome Lists containing this project

README

        


NPM version
CI
Downloads

# Minify Url

> Library to make url shorter

# INSTALLAION

```sh
npm i url-minify
yarn add url-minify
```

# USAGE

Currently 12 providers are supported

For typescript

```ts
import minify from 'url-minify';

~(async function () {
console.log(
await minify('https://rubiin.vercel.app', { provider: 'isgd' }),
);

// ==> {longUrl: 'https://rubiin.vercel.app',shortUrl: 'https://is.gd/PTkruq'}
})();
```

For plain js

```js
const minify = require('url-minify').default;

~(async function () {
console.log(
await minify('https://rubiin.vercel.app', { provider: 'isgd' }),
);

// ==> {longUrl: 'https://rubiin.vercel.app',shortUrl: 'https://is.gd/PTkruq'}
})();
```

## API

### minify(link,options)

#### options

Type: `object`

##### provider

Type: `string`

Service to use for shortening links. Defaults to `isgd`
Available providers: `''isgd' | 'cdpt' | 'vgd' | '4hnet' | 'tinube' | 'rbgy' | 'vurl' | 'haha' | 'pwm' | 'cya' | 'hideuri`

##### timeout

Type: `number`

Response timeout in milliseconds. Defaults to `2000`

# Providers supported

Url shortner supports the following providers.

| Provider | Status |
| ----------- | ------ |
| is.gd | ✔️ |
| cdpt.in | ✔️ |
| tinu.be | ✔️ |
| v.gd | ✔️ |
| rb.gy | ✔️ |
| 4h.net | ✔️ |
| vurl.com | ✔️ |
| pwn.se | ✔️ |
| haha.se | ✔️ |
| cya.se | ✔️ |
| hideuri.com | ✔️ |
| tny.im | ✔️ |

## Contributing

Any types of contributions are welcome. Feel free to send pull requests or create issues.

## License

Licensed under [The MIT License](LICENSE).