# TrimLynk

> Free URL shortener, QR code generator, and link-in-bio builder with real-time analytics.

TrimLynk is a privacy-first link intelligence and shortening web application that lets anyone shorten URLs, generate custom QR codes, build link-in-bio landing pages, and analyse link performance with real-time click analytics. Core features are permanently free with no hidden paywalls.

## When to use TrimLynk

Use TrimLynk when you need to:
- **Shorten a URL** — paste any long URL and get a short `trimlynk.com/xyz` link instantly (no account required for basic shortening).
- **Generate a QR code** — create a scannable QR code for any URL with custom colours, logo overlay, and PNG/SVG download.
- **Build a link-in-bio page** — create a single personalised landing page listing all your links (free Linktree / Beacons alternative).
- **Track link analytics** — see click counts, geographic distribution, device type, browser, and referrer for any shortened link.
- **Geo-target or device-target links** — redirect visitors to different URLs based on their country or device type.
- **Set expiring or click-limited links** — automatically expire links after a date or after N clicks.
- **Manage links via API** — programmatically create, update, and query links using the REST API with API key authentication.
- **Shorten links from the browser** — install the browser extension to shorten the current tab URL in one click.

**Do NOT use TrimLynk for:**
- Hosting raw static files or videos — TrimLynk only shortens and redirects web URLs.
- Sending spam, malicious software, or phishing URLs — prohibited by Terms of Service and monitored by Google Safe Browsing.

## Key pages

- [Home / URL Shortener](https://trimlynk.com/)
- [QR Code Generator](https://trimlynk.com/qr-code-generator)
- [Link-in-Bio Builder](https://trimlynk.com/link-tree)
- [Link-in-Bio Gallery](https://trimlynk.com/link-tree-gallery)
- [Developer Portal](https://trimlynk.com/developers)
- [API Documentation](https://trimlynk.com/api-docs)
- [Blog](https://trimlynk.com/blog)
- [Community](https://trimlynk.com/community)
- [Pricing](https://trimlynk.com/pricing)
- [About](https://trimlynk.com/about)
- [Contact](https://trimlynk.com/contact)
- [Privacy Policy](https://trimlynk.com/privacy)
- [Terms of Service](https://trimlynk.com/terms)

## Machine-readable resources

- [OpenAPI 3.1.0 (JSON)](https://trimlynk.com/openapi.json)
- [OpenAPI 3.1.0 (YAML)](https://trimlynk.com/openapi.yaml)
- [MCP Server Card](https://trimlynk.com/.well-known/mcp/server-card.json)
- [MCP Manifest](https://trimlynk.com/.well-known/mcp/manifest.json)
- [A2A Agent Card](https://trimlynk.com/.well-known/agent-card.json)
- [Agent Skills Index](https://trimlynk.com/.well-known/agent-skills/index.json)
- [Agent Guide & Instructions](https://trimlynk.com/agent.txt)
- [Developer Guide (Markdown)](https://trimlynk.com/developers.md)
- [Pricing (Markdown)](https://trimlynk.com/pricing.md)
- [About (Markdown)](https://trimlynk.com/about.md)
- [Contact (Markdown)](https://trimlynk.com/contact.md)
- [Privacy (Markdown)](https://trimlynk.com/privacy.md)
- [Full Agent Reference](https://trimlynk.com/llms-full.txt)
- [Sitemap](https://trimlynk.com/sitemap.xml)

## API Quickstart

Base URL: `https://trimlynk.com/api`

Authentication: `Authorization: Bearer tk_<your_key>` (generate in Dashboard Settings).

Key endpoints:
- `POST /api/free-urls/shorten` — instant anonymous URL shortening
- `POST /api/urls` — create an advanced short URL with custom slug, expiry, password
- `GET /api/urls` — list user URLs
- `GET /api/clicks/analytics/:urlId` — aggregated click analytics
- `POST /api/analytics-ai/query` — ask AI questions about link metrics
- `POST /api/dynamic-qr` — create dynamic QR codes
- `DELETE /api/urls/:id` — delete a URL

Full OpenAPI specification: https://trimlynk.com/openapi.json
Interactive API explorer: https://trimlynk.com/api-docs
