How to shorten a link
Short answer: paste the long address into the box above, press Generate Short URL, and copy the aczh.dev link that comes back. There is no account to create, no email to confirm and nothing to wait for.
- Paste the address into Target Destination URL. It has to start with
http://orhttps://; anything else is rejected with an error instead of being shortened. - Pick a link type: Shortest for the tiniest code, Secure for a 12-character code nobody can guess, or Sayable for a pronounceable one you can read out loud. Optionally open Custom Slug & Options to type a code of your own instead (3-30 letters, numbers, hyphens, underscores) or add a title that reminds you where the link points.
- Press Generate Short URL and copy the result.
- Press Stats next to the new link whenever you want to see what happened to it.
Why "no ads on the redirect" is the whole point
A short link is a promise about what happens next. Someone taps it because they expect to arrive where they meant to go, and the whole value of the tap is the journey you promised. A shortener that inserts ads, a countdown timer or a continue button spends that promise to pay for itself: the reader loses time, some of them never continue, and the link you printed on a flyer now arrives under someone else's branding instead of yours.
This URL shortener takes the opposite trade. There is no page between the tap and the destination. When someone opens a short link the server answers with a plain 302 straight to the target URL — no interstitial, no countdown, no ad slot, no cookie banner. The redirect costs a few milliseconds, and what renders is entirely the destination you chose.
The same rule applies to the rest of the site. Nothing here is funded by advertising pushed into somebody else's link, so there is nothing for a visitor to dismiss before they reach what they came for.
What the analytics actually track
This shortener records what a click is, plus enough context to tell you where it came from. It does not record who clicked and it does not build a profile. This is the complete list of what is written when someone opens one of your links.
| Metric | What is recorded | Field |
|---|---|---|
| Total clicks | A lifetime counter on the link, incremented once for every redirect, including repeat visits by the same person. | link.click_count |
| Clicks per day | Clicks grouped by calendar day. The query caps the result at 30 rows. | analytics.by_day |
| Top referrers | Up to ten values of the Referer header with their click counts. Clicks sent with no referrer are grouped together and shown as Direct / None. | analytics.top_referrers |
| Recent click stream | The latest 50 clicks, each with a timestamp, the referrer and the User-Agent string the browser sent, truncated to 255 characters. | analytics.recent_clicks |
| Link details | Slug, destination, your title memo, created and updated timestamps, an optional expiry date and whether the link is still active. | link |
| Visitor address | A salted, one-way SHA-256 hash of the IP address, truncated to 16 hex characters. The address itself is never stored, and the hash is never shown in the interface or returned by the API. | clicks.ip_hash |
| Not collected | No country or city, no device or operating-system breakdown, no unique-visitor count per link, no IP address, and no scheduled deletion of the rows above. | — |
The gaps are the feature. Most shorteners price themselves on the location, device and audience breakdowns they buy from a data broker and rebuild out of the visitor's address. This shortener stores a hash that cannot be reversed, derives nothing from it and has nothing to sell. A link nobody has clicked in a year is still there, still resolving, with its history untouched.
Using the API
Everything the interface does is a thin layer over a small REST API under /api/shortener/. Every response is JSON wrapped in success and data; every error comes back as {"error": "..."} with a matching status code. Responses carry Access-Control-Allow-Origin: *, so a page you host yourself can call it straight from the browser. Request bodies are JSON, up to 1 MB.
Sending a key is optional. Pass one as Authorization: Bearer aczh_... or X-API-Key: aczh_... and your request counts against that plan's monthly quota. Send nothing and it falls back to the anonymous limit of 40 creations per minute per IP address.
Create a link
POST /api/shortener/shorten takes url (required), customCode (readable slug), mode ("secure" by default for a 12-character unguessable code, "short" for the tiniest possible code, or "sayable" for a pronounceable one), title, an optional ISO expiresAt and an optional boolean forceNew (default false), and answers 201. A customCode always wins over mode. Without forceNew, shortening the same URL reuses the existing link and the 201 response includes reused true; with forceNew true a new unique link is created instead.
curl -X POST https://aczh.dev/api/shortener/shorten \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"url":"https://example.com/docs","customCode":"my-docs"}'
{"success":true,"data":{
"code":"my-docs",
"short_url":"https://aczh.dev/my-docs",
"qr_code_url":"https://aczh.dev/api/shortener/qr/my-docs",
"original_url":"https://example.com/docs",
"title":"",
"created_at":"2026-10-03T09:12:44.120Z",
"click_count":0,
"reused":false,
"stats_url":"https://aczh.dev/shortener/#stats-my-docs"
}}
The failures are explicit too: 400 when url is missing or malformed, 401 for a key that is unknown or deactivated, 429 when the rate limit or the plan's monthly quota is used up, and a plain error message when your custom slug is already taken.
Read the clicks back
GET /api/shortener/stats/my-docs
{"success":true,"data":{
"link":{"id":1,"code":"my-docs","click_count":42,
"created_at":"2026-10-03 09:12:44","is_active":true},
"analytics":{
"total_clicks":42,
"by_day":[{"date":"2026-10-03","count":42}],
"top_referrers":[{"referer":"Direct / None","count":42}],
"recent_clicks":[{"clicked_at":"2026-10-03 10:04:02",
"referer":"","user_agent":"Mozilla/5.0 ...","country":"Unknown"}]
}}}
The shape is the real one; the values are an example. Notice country on each recent click: it is always Unknown. The column exists in the database and nothing in the redirect handler fills it in, so there is no location data to ask for.
The remaining routes
POST /api/shortener/keys— bodynameandplan(freeorpro). Answers201with the key. The raw key is returned once and never again; only its hash is kept.GET /api/shortener/recent— the 20 most recent active links, each with its short URL and QR address. The My Links community toggle calls exactly this. With?page=N&limit=M(limit capped at 50) it answers a{links, total, page, limit, pages}envelope instead, so the full history is pageable.GET /api/shortener/counts?codes=a,b,canswers{code: clicks}for up to 100 codes (unknown omitted), which is how the list click pills are filled.GET /api/shortener/qr/<code>— a302to a 250×250 QR image for that short link. An unknown code still returns a QR, pointing at the shortener itself.GET /api/shortener/health— liveness./healthzanswers the same thing.
The redirect itself is GET /<code> (the old /s/<code> address still redirects too). It answers 302 to your destination and writes the click before the response leaves, with caching turned off so every visit is counted. An unknown code gets a small Link Not Found page and a 404; a code whose expiry has already passed gets a 410 instead.
Free short links, no account required
Shortening a link here costs nothing, and there is no sign-up step waiting later: no email address, no password, no dashboard, no subscription to cancel. You can close the tab after copying the link and come back in a year, because there is nothing to log into.
That is the honest shape of the privacy story too. There is no account holding your links, so there is nothing to leak, and no identifier tying a click back to a person — the visit is counted and the address is discarded as a hash nobody can reverse. What the service keeps is the minimum needed to redirect your link and tell you it worked.
The one thing to know before you rely on it: because nobody signs in, the slug is the only key to a link. Anyone who guesses it can read the click history through the stats endpoint. For a link you were going to share anyway that is convenient; if it is not, choose a custom slug that cannot be guessed.
Keeping the URL shortener running. Redirects and click logs cost money to host, and there is no advertising on your link to pay for it. If a short link of yours has done its job, a contribution keeps the service up: support aczh.dev.
Shortener API guide
The interface is a thin layer over the API — these are the calls behind it, with copy-paste examples.
Frequently asked questions
Do the short links expire?
Not on their own. There is no scheduled deletion job, so a link made from the web form keeps resolving for as long as the service runs, and its click history is never pruned either.
If you want one to stop on a date, send an ISO expiresAt value with POST /api/shortener/shorten. After that moment the short URL answers 410 Gone and shows a short Link Expired notice instead of redirecting.
Do you show ads, a countdown or anything else before the destination?
Nothing at all. Opening a short link returns a plain 302 straight to the destination URL.
There is no interstitial page, no countdown timer, no ad slot and no cookie banner in that path, so the reader gets what they clicked for and you get every click you paid for.
What happens to the visitor's IP address when someone clicks my link?
The address itself is never written to disk. The redirect handler stores only a salted one-way hash of it: SHA-256 with a fixed salt, truncated to sixteen hex characters.
That hash cannot be turned back into an address, it is not used to derive anything else, and it is never shown in the interface or returned by the stats endpoint. There is no unique-visitor count for a link either.
Can I choose my own short link?
Yes. Open Custom Slug and Options and type a code of 3 to 30 characters using letters, numbers, hyphens and underscores.
It has to be free. If the code already exists the request fails and you pick another one. Leave the field empty and the shortener assigns the shortest available code instead, one character at first and growing longer only when all shorter codes are taken, dealt in scrambled order so neighbouring links never sit next to each other. Shortening the same URL again reuses the existing link unless you tick Create a new unique link (forceNew) or choose a different custom slug, and your links stay listed under My Links on this device.
Who can see the clicks on my link?
Anyone who knows the slug. There is no account to sign in to and the stats endpoint takes no credentials, so the link itself is the only key.
That is convenient when you are sharing a link anyway, and it is not private. If the click history matters, choose a custom slug that cannot be guessed and keep the analytics open to yourself. Reused links keep a single shared click history, and links you create or open stay listed under My Links on this device.
How many links can I create?
From the web form, 40 per minute per IP address. Past that the server answers 429 Too Many Requests until the window rolls over.
With an API key the ceiling is the plan's monthly quota: a free key is created with an allowance of 1,000 calls a month and a pro key with 50,000. The quota is checked on every call and also answers 429 when it is used up.