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"}'

Informazioni su SnapQR

Automatizza la creazione di codici QR e link brevi con un'API REST gratuita: codici dinamici, generazione in blocco, esportazione delle analisi, tagging UTM e domini personalizzati. Nessuna chiave API richiesta — inizia a integrare in pochi minuti.

Domande frequenti

SnapQR è davvero gratuito? Qual è il trucco?

Sì — creare codici QR, codici dinamici, link brevi e analisi è 100% gratuito senza bisogno di account. Non c'è alcuna filigrana e i codici non scadono.

Qual è la differenza tra un codice QR statico e uno dinamico?

Un codice QR statico codifica il contenuto direttamente nel motivo grafico e non può mai essere modificato. Un codice QR dinamico codifica un breve URL di reindirizzamento che controlli tu, così puoi cambiare la destinazione dopo la stampa e monitorare ogni scansione.

I miei codici QR scadono?

No. I codici statici, per loro natura, non smettono mai di funzionare e i codici dinamici restano attivi gratuitamente.

Come modifico un codice QR dopo la stampa?

Quando crei un codice dinamico ottieni un URL di gestione privato. Aprilo, inserisci la nuova destinazione e salva — ogni copia stampata rimanda istantaneamente alla nuova pagina.

Posso aggiungere il mio logo a un codice QR?

Sì. Carica qualsiasi immagine nel pannello Design — viene inserita al centro con un'elevata correzione degli errori così il codice resta scansionabile in modo affidabile. Il logo viene elaborato interamente nel tuo browser.

Quali analisi ottengo?

Per ogni codice: scansioni totali, visitatori unici, scansioni nel tempo, tipo di dispositivo, sistema operativo, browser, paese, città e referrer — con esportazione CSV. Gli indirizzi IP non vengono mai memorizzati.

Quali formati di file posso scaricare?

PNG fino a 4096 px (circa 33 cm a 300 DPI) e vettoriale SVG scalabile all'infinito — entrambi adatti alla stampa professionale.

Posso usare il mio dominio per i link brevi?

Sì — fai puntare un CNAME a snapqr.link e registra il dominio tramite la nostra API. I certificati HTTPS vengono emessi automaticamente.