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

Tso SnapQR ŋu

Wɔ QR kɔdu kple kadodo kpuiwo wɔwɔ wòazu eɖokui tɔ kple REST API femaxee: kɔdu siwo trɔna, agbɔsɔsɔ wɔwɔ, numekukuwo ɖeɖe do goe, UTM dzesideɖe kple dzɔdɔ tɔxɛwo. API safui mehiã o — dze integrating ƒe gɔmedzedze le miniti ʋɛ aɖewo me.

Nyabiabia siwo wobiaa zi geɖe

Ðe SnapQR le femaxee vavã? Nu ɣaɣla kae le eme?

Ɛ̃ — QR kɔdu, kɔdu siwo trɔna, kadodo kpuiwo kple numekukuwo wɔwɔ le femaxee 100% akɔnta manɔmee. Dzesi meli ɖe edzi o eye kɔduwo ƒe ɣeyiɣi mewua enu o.

Vovototo kae le QR kɔdu si metrɔna o kple esi trɔna dome?

QR kɔdu si metrɔna o la kɔda wò nyanyawo tẽ ɖe nɔnɔmetata la me eye womate ŋu atrɔe gbeɖe o. QR kɔdu si trɔna la kɔda URL kpui aɖe si trɔa mɔ si dzi nèkpɔ dzi le, eya ta àte ŋu atrɔ afi si wòfia le tata megbe eye nàkpɔ scan ɖe sia ɖe dzi.

Ðe nye QR kɔduwo ƒe ɣeyiɣi wua enua?

Ao. Le woƒe ɖoɖo nu la, kɔdu siwo metrɔna o metɔa dɔwɔwɔ gbeɖe o, eye kɔdu siwo trɔna la nɔa dɔ wɔm femaxee.

Aleke mawɔ atrɔ QR kɔdu le tata megbe?

Ne èwɔ kɔdu si trɔna la, àxɔ dzikpɔkpɔ URL tɔxɛ aɖe. Ʋui, ŋlɔ afi yeye si wòayi la ɖe eme eye nàdzrae ɖo — kɔpi si wota ɖe sia ɖe fiaa axa yeye la enumake.

Ðe mate ŋu atsɔ nye dzesi akpe QR kɔdu ŋua?

Ɛ̃. Da nɔnɔmetata ɖe sia ɖe ɖe Ðoɖo axa la dzi — wodenɛ titina kple vodada ɖɔɖɔɖo kɔkɔ ale be kɔdu la agakpɔtɔ ade scan nyuie. Wowɔa dɔ kple dzesi la katã le wò browser me.

Numekuku kawoe maxɔ?

Kɔdu ɖe sia ɖe: scan blibowo, amedzro tɔxɛwo, scan siwo dzɔna le ɣeyiɣi me, mɔ̃ ƒomevi, dɔwɔɖoɖo, browser, dukɔ, du kple afi si wòtso — kple CSV ɖeɖe do goe. Womedzraa IP adrɛswo ɖo gbeɖe o.

Faɪl nɔnɔme kawoe mate ŋu ada?

PNG va se ɖe 4096 px (abe inch 13 ene le 300 DPI me) kple SVG vektɔ si woate ŋu akeke mademade — wo evea siaa sɔ na tata si de dɔwɔlawo tɔ.

Ðe mate ŋu azã nye ŋutɔ nye dzɔdɔ na kadodo kpuiwoa?

Ɛ̃ — fia CNAME ɖe snapqr.link gbɔ eye nàŋlɔ dzɔdɔ la ɖe agbalẽ me to míaƒe API dzi. Wonaa HTTPS ƒe agbalẽdede le eɖokui si.