Easy-to-use, powerful python library to help you to shorten urls with advanced options.
Project description
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
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
advurl_shortner-1.0.3.tar.gz
(3.6 kB
view hashes)
Built Distribution
Close
Hashes for advurl_shortner-1.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 76c42325006d50d5da0ca417231234d273b59819dcfa96d7c2140d73712009f8 |
|
MD5 | 9121ae8cbdeb3ad94cf403dd53e7f6ec |
|
BLAKE2b-256 | 6d2d41e2462dd405c8997282efaed3652118463275b5929dfca02c227ddb900d |