advurl-shortner

advurl_shortner - Advanced URL Shortener for Python

Easy-to-use, powerful python library to help you to shorten urls with advanced options. Supports multiple domains, URL TTL, split tests, visit statistics etc. An extended native Python wrapper for AdvUrlShortner API with minimal requirements. Supports all methods and types of responses.

Features

• Easy to use
• Multiple domains
• URL TTL (Time-To-Live) in seconds. Auto expiry URL after some time.
• Redirect to second URL after primary URL expires (TTL)
• Randomized and weighted randomnized redirect to different URLs (split tests etc.)
• Password-protected statistics of visits to a shortened URL
• Password protected shortened URL parameters (TTL, second URL, etc.)

Installation

In order install this package, simply run:

pip install advurl_shortner

Usage

To use shorten_url, you first need to import the package:

import advurl_shortner

Shorten URL:

advurl_shortner.short("https://google.com/")
# Returns the shortened URLs in JSON
# Example: {"urls": ["https://liii.pw/N", "https://illi.ink/N", "https://illi.cfd/N"]}

advurl_shortner.short("https://google.com/", description="Google search engine", password="1234x")
# Returns shortened URLs, sets a password to access visiting statistics and shortened URL parameters.

advurl_shortner.short("https://google.com/", ttl=86400)
# Returns the shortened URLs., after 24 hours (86400 seconds) will return "The Link You Followed Has Expired"

advurl_shortner.short("https://google.com/", ttl=86400, second_url="https://bing.com/")
# Returns the shortened URLs., after 24 hours (86400 seconds)  shortened link will redirect to second_url

advurl_shortner.short("https://google.com/",second_url="https://bing.com/")
# Returns shortened URLs. The shortened link is randomly redirected to one of the provided URLs.

advurl_shortner.short("https://google.com/",second_url="https://bing.com/", weights=[0.3, 0.7])
# Returns shortened URLs.
# The shortened link is randomly (weighted by weight parameter) redirected to one of the provided URLs.
# approximately 30% to "https://google.com/ and 70% to "https://bing.com/"

Getting short URL parameters and visit statistics:

advurl_shortner.stat("https://illi.cfd/H","aaa")
# Returns the parameters and visit statistics of the shortened URL stored with password "1234x".
# Example:
#{
#	"url": "http://google.com/?z=1",
#	"second_url": "http://yahoo.com/",
#	"ttl": null,
#	"date_created": "1703411470",
#	"weights": null,
#	"description":"Yahoo search engine",
#	"visits": 4,
#	"primary_url_expired": false
#}

TODO:

• More than 2 URLs
• Advanced visit statistics