# Shortener.dev

> URL shortener with click analytics. Create short links with custom back-halves, UTM parameters, expiration, passwords, iOS and Android app targeting and geo targeting, from the dashboard or the REST API.

Destination URLs must be on a domain verified in the account or on the global whitelist. The API base URL is https://api.shortener.dev/v1 and requests authenticate with `Authorization: Bearer <API key>`.

## Get started

- [Shortener.dev documentation](https://shortener.dev/docs/index.md): How to create short links, add UTM tracking, expiration, passwords and geo targeting, verify your domains and read click analytics in Shortener.dev.
- [Shorten links from Chrome and Firefox with the browser extension](https://shortener.dev/docs/browser-extension.md): Install the Shortener.dev extension for Chrome or Firefox, shorten the page you are on in one click, shorten links with right click and check clicks from the side panel.

## Short links

- [Create a short link](https://shortener.dev/docs/create-short-link.md): Shorten a long URL with a custom back-half in the Shortener.dev link builder, preview how it looks on social media, and copy it to share.
- [Find, copy and delete short links](https://shortener.dev/docs/manage-links.md): Search your short links, switch between list and grid view, copy or open a link, and permanently delete links you no longer need.
- [Create a QR code for a short link](https://shortener.dev/docs/qr-codes.md): Turn any short link into a QR code in the Shortener.dev dashboard, choose its size and colors, and download it as PNG or SVG. Track scans and change the destination after printing.

## Link options

- [Set an expiration date on a short link](https://shortener.dev/docs/link-expiration.md): Make a short link stop working automatically at a date and time, for limited-time offers, event registrations and temporary campaigns.
- [Add UTM parameters to a short link](https://shortener.dev/docs/utm-parameters.md): Use the UTM Builder to tag short links with utm_source, utm_medium and utm_campaign, so Google Analytics shows which campaign brought each visitor.
- [Customize the social media preview of a short link](https://shortener.dev/docs/social-media-preview.md): Set a custom Open Graph title, description and image for a short link, and check how it looks on Twitter / X, Facebook and LinkedIn before you share it.
- [Create a password protected short link](https://shortener.dev/docs/password-protected-links.md): Restrict a short link with a password, so only people you share the password with can open the destination page.
- [Send iPhone and Android users to your app](https://shortener.dev/docs/ios-android-app-links.md): Use iOS Targeting and Android Targeting to send mobile visitors to the App Store or Google Play, while desktop visitors go to your website.
- [Redirect visitors by country with geo targeting](https://shortener.dev/docs/geo-targeting.md): Send visitors from specific countries to a localized page, store or currency with one geo-targeted short link.

## Domains

- [Verify a domain to shorten links to your website](https://shortener.dev/docs/verify-domain.md): Add your domain to Shortener.dev and verify you own it with an email code or Google Search Console, so you can create short links to any page on it.
- [Manage your domains and the whitelist](https://shortener.dev/docs/manage-domains.md): See which domains you can shorten links to, browse the global whitelist of popular sites, set a default domain, and remove domains you no longer use.

## Analytics

- [Track clicks with link analytics](https://shortener.dev/docs/click-analytics.md): See how many clicks your short links get over time, and which countries, referrers, browsers, operating systems and devices they come from.
- [View the raw click log](https://shortener.dev/docs/click-reports.md): The Reports page lists each click on your short links with the time, location, browser, device and referrer of the visitor.

## Team and API

- [Invite team members](https://shortener.dev/docs/team-members.md): Add colleagues to your Shortener.dev account so they can create and manage short links with you, change their role, or remove them.
- [Create an API key](https://shortener.dev/docs/api-keys.md): Create a Shortener.dev API key to create short links and read analytics from your own server, scripts or no-code tools.
- [Shorten URLs with the API](https://shortener.dev/docs/url-shortener-api.md): Create, list, update and delete short links with the Shortener.dev REST API, with examples in cURL, JavaScript and Python.

## API

- [OpenAPI spec](https://api.shortener.dev/openapi.json): Machine-readable spec of every endpoint
- [API reference](https://shortener.dev/docs/api): Interactive reference
- [Agent skill](https://shortener.dev/.well-known/agent-skills/SKILL.md): How an AI agent should use the API

## Optional

- [Full docs](https://shortener.dev/llms-full.txt): Every docs page in one file