🖇️ Shortening URLs

Method for shortening URLs using e-z.host.

POSThttps://api.e-z.gg/shortener

Headers

Name	Type	Description
key*	String	API Key

Request Body

Name	Type	Description
url*	String	URL you want to shorten

Request example

cURL

curl -X POST "https://api.e-z.gg/shortener" \
  -H "key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com"
}'

JavaScript

const res = await fetch("https://api.e-z.gg/shortener", {
  method: "POST",
  headers: {
    "key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://example.com"
  })
});

const data = await res.json();
console.log(data);

Python

import requests

res = requests.post(
    "https://api.e-z.gg/shortener",
    headers={"key": "YOUR_API_KEY"},
    json={
        "url": "https://example.com"
    },
)

print(res.json())

Responses

200: OK

{
  "success": true,
  "shortendUrl": "https://<domain>/s/<shortenedid>",
  "deletionUrl": "https://api.e-z.gg/shortener/delete?key=<urlkey>",
  "document": {
    "shortId": "<shortenedid>",
    "destination": "https://<destination>",
    "deletionKey": "<urlkey>",
    "timestamp": "2026-08-10T21:55:18.550Z",
    "user": "<userid>"
  }
}

400: Bad Request

{
  "success": false,
  "error": "error message"
}

401: Unauthorized

{
  "success": false,
  "error": "error message"
}

404: Not Found

{
  "success": false,
  "error": "error message"
}

500: Internal Server Error

{
  "success": false,
  "error": "error message"
}