Building integrations should feel effortless. In API v1 and v2, developers had to query available domains, extract internal ULIDs, and pass verbose payloads. With API v3, we have reimagined the developer experience from the ground up: making link shortening more intuitive, resilient, and concise.
1. No domain_id Required: Preferred Domains & Fallback
Every API key can now have an assigned preferred domain (with automatic fallback to href.nz). When shortening a link via POST /v3/links, you no longer need to pass domain_id:
POST /v3/links
Authorization: Bearer tl_...
Content-Type: application/json
{
"url": "https://example.com/product-launch"
}
The system automatically resolves the target domain according to your preference — whether that is meinlink.at, href.nz, or your own custom domain. Prefer to specify a domain inline? Simply pass the hostname string directly: "domain": "meinlink.at".
2. Intuitive Field Aliases & Shorthands
API v3 adopts natural naming conventions:
url: An intuitive alias fordestination_url.expires_in: Human-friendly duration strings like"30d","24h","7d", or"3600"seconds instead of having to calculate ISO-8601 timestamps.- Nested
utmObject: Send{ "source": "github", "medium": "docs", "campaign": "v3" }directly in your request payload. - Comma-Separated Tags: Pass
"tags": "api, automation"or an array.
3. High-Velocity Bulk Shortening
Need to shorten campaign links in batches? API v3 introduces POST /v3/links/bulk, allowing up to 50 links per single HTTP request:
POST /v3/links/bulk
{
"links": [
{ "url": "https://example.com/page-1", "slug": "spring-1" },
{ "url": "https://example.com/page-2", "domain": "meinlink.at" }
]
}
The endpoint returns individual per-link statuses alongside overall batch summary counters.
4. Vector QR Codes and Deep Analytics Endpoints
API v3 also exposes first-class endpoints for QR codes and analytics:
- Dynamic QR Codes (
GET /v3/links/{link}/qr): Request infinite-resolution SVG (?format=svg) or raster PNG (?format=png&size=500) directly from the API for automated collateral generation. - Comprehensive Analytics (
GET /v3/links/{link}/analytics): Query clean, pre-aggregated metrics including 24-hour, 7-day, and 30-day click counts, top referrers, and country breakdowns.
Explore the complete API v3 schema and endpoint discovery at GET /v3.