API Version 1.0

Base URL: https://anonshort.com/api/

URL Shortener API Documentation

Welcome to the URL Shortener API documentation. This API allows you to shorten URLs and retrieve statistics about the shortened URLs.

Endpoints

ENDPOINT

1. Shorten a URL

POST /api/

Parameters

Parameter	Type	Required	Description
`url`	string	Yes	The URL to be shortened
`custom_path`	string	No	Custom path for the shortened URL

Response

{
    "short_url": "https://anonshort.com/shortened-path",
    "stats_url": "https://anonshort.com/index.php?stats=stats-token"
}

ENDPOINT

2. Get URL Statistics

GET /api/?stats={stats_token}

Parameters

Parameter	Type	Required	Description
`stats_token`	string	Yes	The token used to retrieve statistics for a shortened URL

Response

{
    "url": "https://www.example.com",
    "clicks": 0,
    "created_at": "2024-09-03 06:42:09"
}

Example Usage

Shorten a URL using cURL

curl -X POST -d "url=https://www.example.com" -d "custom_path=mycustompath" https://anonshort.com/api/

Shorten a URL using Python

import requests

url = "https://anonshort.com/api/"
data = {
    'url': 'https://www.example.com',
    'custom_path': 'mycustompath'
}

response = requests.post(url, data=data)

if response.status_code == 200:
    print("Shortened URL:", response.json().get('short_url'))
    print("Stats URL:", response.json().get('stats_url'))
else:
    print("Error:", response.status_code, response.json())

Shorten a URL using Node.js

const axios = require('axios');

const url = 'https://anonshort.com/api/';
const data = {
    url: 'https://www.example.com',
    custom_path: 'mycustompath'
};

axios.post(url, new URLSearchParams(data))
    .then(response => {
        console.log('Shortened URL:', response.data.short_url);
        console.log('Stats URL:', response.data.stats_url);
    })
    .catch(error => {
        console.error('Error:', error.response ? error.response.data : error.message);
    });

HTTP Response Codes

200

Success

Request was successful

400

Bad Request

Missing required parameters

405

Method Not Allowed

HTTP method not supported

429

Too Many Requests

Rate limit exceeded

500

Server Error

Internal server error

Contact

If you have any questions or feedback, please feel free to contact us:

anonshort@tutamail.com

GitHub Issues