Build on the link layer.

One REST API for links, smart routing and analytics — try the request shape right here. Type a destination, flip a rule, watch the request write itself.

Interactive example: you type a destination URL and toggle options — iOS route, geo DE, expiry, custom slug. A POST request to /v1/links writes itself with the url, an optional slug, a routing array of if/to rules and expires_at matching your choices, and a 201 Created response answers with the link object: id, slug, the short_url (for example https://rii.link/summer-sale), the routing array and timestamps. The panes are a simulation of the real API contract; routing rules need a Premium plan.

link forgePOST /v1/links
Developer API

Drop link superpowers into your stack.

A fast, predictable REST API with a live event stream. Create, route, brand and measure links from anywhere in your software — in a few lines.

POST/v1/linksCreate a link
GET/v1/links/:idFetch a link
PATCH/v1/links/:idUpdate routing
POST/v1/qrGenerate a QR
GET/v1/links/:id/statsClick & geo data
DEL/v1/links/:idRemove a link
Plain HTTPS · any language · OpenAPICreate an API key→
// Create a smart link (routing rules need Premium)
const res = await fetch("https://api.rii.link/v1/links", {
  method: "POST",
  headers: { Authorization: "Bearer rii_live_…",
             "Content-Type": "application/json" },
  body: JSON.stringify({
    url: "https://myshop.com",
    slug: "summer-sale",
    routing: [{ if: { device: "ios" },
                to: "https://apps.apple.com/app/id123" }],
  }),
});
// → 201 Created · rii.link/summer-sale
Versioned /v1

Breaking changes only ever land behind a new version prefix.

Errors you can parse

Every error is JSON with a stable machine-readable code.

Live click stream

Human clicks on your API-created links, streamed over SSE.

Honest rate limits

Limits live in response headers, not in surprise 429s.

Model Context Protocol

Let agents create, update & analyze links for you.

Connect https://mcp.rii.link with OAuth and your AI assistant manages links the way it manages files — each agent stays visible, scoped and revocable in your rii.link account.

Example conversation: the user asks the assistant to create a branded link for the summer sale that routes iPhone users to the App Store, and to show last week's clicks. The assistant calls the create_link tool to create rii.link/summer-sale with iOS traffic routed to the App Store, then calls link_stats, which returns 18,423 clicks over the last 7 days with Germany as the top geography, and confirms the link is live with those results. MCP link management is live — shipped August 2026, ahead of its promised date.

Links from a sentence

"Shorten this and route DE traffic to /de" becomes a real, live link — no dashboard clicks.

Update & route in place

Agents repoint destinations and add rules through typed tool calls — QR codes follow automatically.

Analytics on demand

Ask for clicks, geos or top links and get structured results back into the conversation.

create_linklist_linksupdate_linkdelete_linklist_domainsrender_qrlink_stats
Webhooks · roadmap

Your stack will hear every click.

Outbound webhooks — push delivery to your own endpoint — are on the roadmap for Q1 2027. Live today: a server-sent click stream for your API-created links, one curl -N away.

Outbound webhooks are on the roadmap for Q1 2027 and are not available yet. What works today is the live server-sent event stream, GET /v1/events/stream: one click event per human click on links created through the public API. Example events: a mobile click from Germany via instagram.com, a desktop QR scan from the US, a mobile click from France tagged utm_source=newsletter, and a desktop click from Germany that matched the rule geo.country == "DE".

stream-clicks.sh
# Live today: human clicks on your API-created links
$ curl -N https://api.rii.link/v1/events/stream \
    -H "Authorization: Bearer $RII_KEY"

: connected

event: click
data: {"link_id":"lnk_8h2f0qZ3Tk1mR4vXw9aBcQ",
       "country":"DE","device":"mobile",
       "referrer":"instagram.com","is_qr":false, …}

# Outbound webhooks (push to your endpoint): Q1 2027

Ready to build smarter connections?

Branded links, visual routing and LLM-ready responses — start free, no credit card needed.

✓No credit card✓Free forever tier✓GDPR / DSGVO compliant✓Export & leave anytime