Skip to main content
Publishing

Short links

Tracked short links with UTM parameters, click statistics and automatic shortening when a post is published.

Creating links

Open Short links in the sidebar and choose New link. Enter the destination URL, optionally a custom ending (3 to 40 letters, digits, - or _; some words are reserved) and UTM parameters. The short address looks like https://plotpostapi.kriva.studio/l/spring-sale. Archiving a link makes it stop redirecting; its statistics are kept.

UTM and the default template

UTM parameters (utm_source, utm_medium, utm_campaign, utm_term, utm_content) are added to the destination when someone clicks. A parameter that is already in the destination URL is never overwritten.

Default UTM sets a template per workspace. {platform} becomes the channel the post goes to, {campaign} the post campaign name and {date} the publish date (IST).

In the composer

Turn on Shorten links and add UTM when you write a post. The text you write is never changed. When each channel publishes, every URL in that channel's copy of the text is replaced by a short link that carries the default UTM template with the channel as source. The same URL and UTM reuse the same short link, so retries do not create duplicates. Those links show up under Auto-created.

What is counted

  • Real visits only: crawlers, link-preview fetchers, HEAD requests and browser prefetches are not counted (bot visits are tallied separately).
  • Stored per click: time, the referrer host (not the full URL), the country when the CDN provides a header (Cloudflare, Vercel or CloudFront) and a device class. IP addresses and full user agents are never stored.
  • Charts use IST days. The redirect is a 302 that is not cached so every visit is counted and edits take effect at once. It is rate limited per IP.

API

EndpointPurpose
GET /api/links?application_id=List links with click totals
POST /api/linksCreate (application_id, target_url, slug, utm, title)
PATCH /api/links/:idEdit or archive (status)
GET /api/links/stats?application_id=&link_id=&days=Clicks by day, referrers, countries, devices
GET/PUT /api/links/settingsDefault UTM template
GET /l/:slugPublic redirect

v0.1.2

Short links | Documentation | Sociquza