Short link and QR code API

The Krealo QR REST API lets you create short links, list them, change their destination and fetch their QR code from your own tools. It is available on the Pro plan only, at $5.99 a month plus taxes. You generate a personal token on your account page and send it in the Authorization header.

Create my first QR Pricing

POST /links

curl -X POST https://qr.krealomedia.com/api/v1/links \
  -H "Authorization: Bearer kqr_…" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/menu","slug":"menu"}'

GET /links

curl https://qr.krealomedia.com/api/v1/links?limit=25 \
  -H "Authorization: Bearer kqr_…"

GET /links/{slug}

curl https://qr.krealomedia.com/api/v1/links/menu -H "Authorization: Bearer kqr_…"

{ "slug": "menu", "short_url": "https://qr.krealomedia.com/menu", "url": "https://example.com/menu",
  "active": true, "clicks": 42, "stats": { "by_day": { … }, "by_country": { "CA": 40 } } }

PATCH /links/{slug}

curl -X PATCH https://qr.krealomedia.com/api/v1/links/menu \
  -H "Authorization: Bearer kqr_…" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/menu-hiver","active":true}'

GET /links/{slug}/qr

curl "https://qr.krealomedia.com/api/v1/links/menu/qr?format=svg" -H "Authorization: Bearer kqr_…" -o menu.svg

401 unauthorized · 402 pro_required · 404 not_found · 409 slug_taken · 429 rate_limited (120/min)

Authentication

The API is for Pro accounts only. Generate your personal token on your account page, then send it in the header Authorization: Bearer <token>. The base URL is https://qr.krealomedia.com/api/v1.

Available endpoints

GET /links: list your links, with cursor pagination.
POST /links: create a link (url field, optional slug).
GET /links/{slug}: return a link with its click count.
PATCH /links/{slug}: change the url or the active state.
GET /links/{slug}/qr?format=svg|png: return the black-and-white QR code.

Rate limit

The limit is 120 requests per minute. Beyond that, wait for the next minute before retrying.

Accepted destinations

Only http and https addresses are accepted. Dangerous destinations, such as javascript: or data:, are blocked.

Frequently asked questions

Who can use the API?

Pro plan accounts. The personal token is generated on the account page.

What is the request limit?

It is 120 requests per minute.

Can the QR code returned by the API have a logo?

No. The /links/{slug}/qr endpoint returns a black-and-white QR code, as SVG or PNG. Logo and colours are set from the app.