SnapQR API

Create and manage QR codes and short links programmatically. No API key, no signup — the token returned at creation is the credential for that link. Base URL: https://snapqr.link/api

Create a link / dynamic QR

POST /api/links
Content-Type: application/json

{
  "kind": "url",                  // url | appstore | vcard | page
  "target": "https://example.com/menu",
  "alias": "summer-menu",         // optional custom code
  "title": "Summer menu",         // optional
  "campaign": "summer",           // optional grouping tag
  "utm": {                        // optional, auto-appended on redirect
    "utm_source": "poster", "utm_medium": "qr", "utm_campaign": "summer2026"
  }
}

Response 201:

{
  "code": "summer-menu",
  "short_url": "https://snapqr.link/summer-menu",
  "qr_png": "https://snapqr.link/summer-menu/qr.png",
  "qr_svg": "https://snapqr.link/summer-menu/qr.svg",
  "manage_url": "https://snapqr.link/m/<token>",
  "token": "<token>"            // keep secret — grants edit + analytics access
}

For kind: "appstore" send ios, android, fallback URLs. For kind: "vcard" send firstName, lastName, org, jobTitle, phone, email, website. For kind: "page" send headline, description and a links array of {label, url}.

Manage & analytics

GET    /api/manage/{token}            # link details + totals
PUT    /api/manage/{token}            # update target/payload/utm/active/title
DELETE /api/manage/{token}            # delete link + analytics
GET    /api/manage/{token}/stats?days=30
GET    /api/manage/{token}/scans.csv  # raw scan export

/stats returns totals, unique visitors, a per-day series and top-10 breakdowns for device, OS, browser, country, city, referrer and QR-vs-link source.

Bulk creation

POST /api/bulk            # JSON array of link objects, or {"csv": "alias,target,title,campaign\n..."}
POST /api/bulk?format=csv  # same, responds with a CSV of created codes

Max 500 rows per request.

QR images

GET /api/qr?data=hello&size=1024&fg=%23000000&bg=%23ffffff&format=png|svg&ecl=M
GET /{code}/qr.png   GET /{code}/qr.svg    # QR for an existing short code

Custom domains

POST /api/domains  {"domain": "qr.yourbrand.com"}

Then point a CNAME for that hostname at snapqr.link. TLS certificates are issued automatically on first visit, and your short codes resolve on your own domain.

Limits

Fair-use rate limits apply per IP (60 links/hour, 10 bulk requests/hour, 300 QR images/hour). Destinations must be public http(s) URLs. Codes serving malware or phishing are removed.

Example: curl

curl -X POST https://snapqr.link/api/links \
  -H "Content-Type: application/json" \
  -d '{"kind":"url","target":"https://example.com","alias":"demo-123"}'

A prepaus de SnapQR

Automatizatz la creacion de còdis QR e de ligams corts amb una API REST gratuita: còdis dinamics, generacion en massa, exportacion d'analitica, etiquetatge UTM e domenis personalizats. Cap de clau API necessària — començatz a integrar en qualques minutas.

Questions frequentas

SnapQR es vertadièrament gratuit? Ont es l'estirga?

Òc — crear de còdis QR, de còdis dinamics, de ligams corts e l'analitica es 100% gratuit sens compte necessari. I a pas de filigrana e los còdis expiran pas.

Quina es la diferéncia entre un còdi QR estatic e un còdi QR dinamic?

Un còdi QR estatic encòda vòstre contengut dirèctament dins lo motiu e pòt pas jamai èsser cambiat. Un còdi QR dinamic encòda una URL de redireccion corta que contrarotlatz, atal podètz cambiar cap a ont mena aprèp l'estampatge e seguir cada escanatge.

Mos còdis QR expiran?

Non. Los còdis estatics daissan pas jamai de foncionar per concepcion, e los còdis dinamics demòran actius gratuitament.

Cossí modifiqui un còdi QR aprèp l'estampatge?

Quand creatz un còdi dinamic, recebètz una URL de gestion privada. Dobrissètz-la, picatz la nòva destinacion e enregistratz — cada còpia estampada mena a l'instant cap a la nòva pagina.

Pòdi apondre mon lògo a un còdi QR?

Òc. Cargatz quina imatge que siá dins lo panèl Design — es incrustada al centre amb una nauta correccion d'errors per que lo còdi contunhe de s'escanar de faiçon fisabla. Lo lògo es tractat entièrament dins vòstre navigador.

Quina analitica recebi?

Per còdi: escanatges totals, visitaires unics, escanatges dins lo temps, tipe d'aparelh, sistèma operatiu, navigador, país, vila e referent — amb exportacion CSV. Las adreças IP son pas jamai enregistradas.

Quins formats de fichièr pòdi telecargar?

PNG fins a 4096 px (environ 13 poces a 300 DPI) e vector SVG escalable a l'infinit — totes dos convenables per l'estampatge professional.

Pòdi utilizar mon pròpri domeni pels ligams corts?

Òc — dirigissètz un CNAME cap a snapqr.link e enregistratz lo domeni via nòstra API. Los certificats HTTPS son emeses automaticament.