qrrq-qr-generator

Official Node.js client for QRRQ — Free QR Code Generator with real-time analytics, custom designs, and 15+ QR code types.

Installation

npm install qrrq-qr-generator

Quick Start

const QRRQClient = require('qrrq-qr-generator');

const qr = new QRRQClient('YOUR_API_KEY');

// Create a URL QR code
const result = await qr.create({
  type: 'url',
  title: 'My Website',
  data: { url: 'https://example.com' }
});

console.log(result);

Supported QR Code Types

| Type | Description | Data Fields | |---|---|---| | url | Website link | url | | pdf | Document sharing | file (base64) | | vcard | Digital business card | firstName, lastName, phone, email, company, website, address | | wifi | WiFi connection | ssid, password, encryption | | email | Pre-filled email | address, subject, body | | phone | Instant dial | number | | sms | Text message | number, message | | whatsapp | WhatsApp chat | number, message | | location | Google Maps pin | latitude, longitude, name | | event | Calendar event | title, startDate, endDate, location, description | | text | Plain text | text | | social | Social profiles | platforms (array) | | multiurl | Smart redirects | urls (array with rules) | | app | App Store links | ios, android | | crypto | Wallet address | currency, address, amount |

API Methods

Create a QR Code

const result = await qr.create({
  type: 'vcard',
  title: 'John Doe',
  data: {
    firstName: 'John',
    lastName: 'Doe',
    phone: '+1234567890',
    email: '[email protected]',
    company: 'Acme Inc'
  }
});

Create with Custom Design

const result = await qr.create({
  type: 'url',
  title: 'Branded QR',
  data: { url: 'https://example.com' },
  design: {
    foregroundColor: '#6366f1',
    backgroundColor: '#ffffff',
    pattern: 'dots',
    eyeShape: 'rounded'
  }
});

Create with Rules (Password, Expiry, Scan Limit)

const result = await qr.create({
  type: 'url',
  title: 'Limited Offer',
  data: { url: 'https://example.com/promo' },
  rules: {
    password: 'secret123',
    expires_at: '2026-12-31',
    scan_limit: 1000
  }
});

List All QR Codes

const list = await qr.list();

Get a QR Code

const item = await qr.get(123);

Update a QR Code

await qr.update(123, {
  title: 'Updated Title',
  data: { url: 'https://new-url.com' }
});

Delete a QR Code

await qr.delete(123);

Get Scan Analytics

const stats = await qr.analytics(123);
// Returns: total_scans, unique_scans, scans_by_country, scans_by_device, scans_by_date

Get Dashboard Overview

const overview = await qr.overview();

Error Handling

try {
  await qr.create({ type: 'url', title: 'Test', data: { url: 'https://example.com' } });
} catch (error) {
  console.error(error.message);  // Error description
  console.error(error.status);   // HTTP status code
  console.error(error.response); // Full API response
}

Get Your API Key

1. Sign up free at free QR code generator
2. Go to Dashboard → API section
3. Generate your API key
4. QR code API documentation →

Features

• Dynamic QR Codes — Edit destination URL anytime without reprinting
• Real-Time Analytics — Track scans by location, device, browser, and time
• Custom Designs — Colors, logos, patterns, eye shapes, and frames
• Password Protection — Secure QR codes with passwords
• Link Pages — Micro landing pages with multiple links, social media, videos & more
• 15+ QR Types — URL, PDF, vCard, WiFi, Email, Phone, SMS, WhatsApp, and more
• Multi-Language — Available in English, Turkish, German, Spanish, and Russian

Links

• Website: Free QR Code Generator
• Pricing: QR Code Generator Pricing
• Features: QR Code Generator Features
• API Docs: QR Code API Documentation
• GitHub: QR Code Generator Source Code
• Blog: QR Code Generator Blog

License

MIT — Free QR Code Generator