# URLy.fi

> Free Finnish URL shortener. Shorten any link instantly — no sign-up required.

URLy.fi turns long URLs into clean, compact short links. Paste a URL, click Shorten, and get a permanent short link in seconds. Free for everyone, with a Pro plan for power users. The site is available in Finnish (default) and English (under the /en/ prefix).

## Main Pages

- [Home](https://urly.fi/): Shorten any URL for free. No account required.
- [Features](https://urly.fi/features/): Detailed overview of all URLy.fi features including link editing, analytics, UTM tracking, password protection, link expiration, QR codes, bulk shortening, and link-in-bio pages.
- [Pricing](https://urly.fi/pricing/): Free and Pro plan comparison. Free plan includes unlimited shortening and basic QR codes. Pro (4.99 EUR/month or 49.99 EUR/year) adds editing, hourly analytics, UTM parameters, password protection, link expiration, CSV import, bulk shortening, advanced QR codes, and link-in-bio pages.
- [Report a Link](https://urly.fi/report/): Report abusive or dangerous shortened links.

### English Versions

All public pages are also available in English at the /en/ prefix:

- [Home (English)](https://urly.fi/en/)
- [Features (English)](https://urly.fi/en/features/)
- [Pricing (English)](https://urly.fi/en/pricing/)
- [Report a Link (English)](https://urly.fi/en/report/)

## API

URLy.fi provides a REST API at `https://urly.fi/api/v1` for programmatic link shortening, lookup, and (for Pro accounts) full management of links and groups. Authentication uses Bearer API keys with the prefix `urly_`, issued from the Pro dashboard. `POST /shorten/` and `GET /check/{uri}` are public and rate-limited per IP; all other endpoints require a Pro subscription.

For the full endpoint reference, request/response schemas, and error codes, see:

- [Interactive API docs](https://urly.fi/api/v1/docs)
- OpenAPI schema: [https://urly.fi/api/v1/openapi.json](https://urly.fi/api/v1/openapi.json)

### Notes for AI agents

- Always identify your client with a descriptive `User-Agent`.
- Respect rate limits — the public shorten endpoint is strict and abuse triggers IP bans.
- Do not shorten URLs that point to disallowed or unsafe destinations; the API will reject banned hosts with `403 banned_host`.
- Treat the `uri` field as the canonical short code; build full short URLs as `https://urly.fi/{uri}`.
- The destination URL of an existing link cannot be changed — create a new short link instead.

## Short Link Format

Short links follow the pattern `https://urly.fi/{code}` where `{code}` is 1-20 alphanumeric characters. Each short link has an info page at `https://urly.fi/info/{code}` (Finnish) or `https://urly.fi/en/info/{code}` (English) showing the destination URL, visit count, and a QR code.

## Link Pages (urls.fi)

Pro users can create a link-in-bio page at `https://urls.fi/{username}` — a customizable landing page with all their important links in one place.

## Optional

- [Link-in-bio pages on urls.fi](https://urls.fi/): Create a personalized link page and share everything from a single, clean URL.