QR Code Generator API

A powerful Apify Actor for programmatic QR code generation, customization, and management. Supports bulk processing, multiple formats, and advanced customization options.

🚀 Features

Core Functionality

• Multiple Data Types: URL, text, WiFi credentials, vCard, email, SMS, phone
• Bulk Processing: Generate multiple QR codes simultaneously for efficient workflow
• Advanced Customization: Colors, sizes, error correction levels, logo integration
• Multiple Output Formats: PNG, SVG (PDF support ready)
• Analytics Tracking: Optional usage statistics and performance monitoring
• Brand Consistency: Support for custom color schemes and logo embedding

Technical Features

• TypeScript Support: Complete type safety and modern development experience
• Error Handling: Graceful error handling and recovery mechanisms
• File Management: Support for separate files or ZIP archive output
• Data Validation: Strict JSON schema validation
• Apify Best Practices: Full compliance with Apify platform standards

📋 Input Parameters

Basic Structure

{
  "data": [
    {
      "content": "https://www.example.com",
      "dataType": "url",
      "size": 300,
      "format": "png",
      "errorCorrectionLevel": "M",
      "darkColor": "#000000",
      "lightColor": "#FFFFFF"
    }
  ],
  "outputFormat": "separate",
  "enableAnalytics": true
}

Supported Data Types

Data Type	Description	Example
url	Website links	https://www.apify.com
text	Plain text	Welcome to our service!
wifi	WiFi credentials	NetworkName:Password
vcard	Contact cards	John Doe
email	Email addresses	contact@example.com
sms	SMS messages	+1234567890
phone	Phone numbers	+1234567890

Customization Options

Parameter	Type	Default	Description
size	Number	300	QR code image size in pixels
format	String	"png"	Output format: png, svg, pdf
errorCorrectionLevel	String	"M"	Error correction level: L, M, Q, H
darkColor	String	"#000000"	Dark modules color (hex)
lightColor	String	"#FFFFFF"	Light modules color (hex)
logo	String	-	Logo image URL
logoSize	Number	50	Logo size in pixels

Global Options

Parameter	Type	Default	Description
outputFormat	String	"separate"	Output format: separate (individual files) or zip (archive)
enableAnalytics	Boolean	false	Enable analytics tracking

📊 Output Format

Basic Output Structure

{
  "results": [
    {
      "id": "qr-1",
      "content": "https://www.example.com",
      "dataType": "url",
      "format": "png",
      "size": 300,
      "fileName": "qr-url-1-1234567890.png",
      "filePath": "qr-url-1-1234567890.png",
      "downloadUrl": "key-value-store:qr-url-1-1234567890.png",
      "generatedAt": "2025-01-01T00:00:00.000Z",
      "errorCorrectionLevel": "M",
      "darkColor": "#000000",
      "lightColor": "#FFFFFF",
      "hasLogo": false
    }
  ],
  "generatedCount": 1,
  "outputFormat": "separate"
}

🎯 Use Cases

Marketing Campaigns

• Generate branded QR codes for promotional activities
• Batch creation of product link QR codes
• Event tickets and venue information QR codes

E-commerce

• Product page link QR codes
• Promotional campaigns and discount code QR codes
• Payment and order tracking QR codes

Business Applications

• Contact information and business card QR codes
• Contactless menus and service QR codes
• WiFi network sharing QR codes

Development Integration

• QR code functionality in applications
• Automated workflow integration
• Bulk QR code generation API

📖 Usage Examples

Basic URL QR Code

{
  "data": [
    {
      "content": "https://www.apify.com",
      "dataType": "url",
      "size": 300,
      "format": "png"
    }
  ]
}

Batch Generation with Different Types

{
  "data": [
    {
      "content": "https://www.example.com",
      "dataType": "url",
      "size": 300,
      "format": "png"
    },
    {
      "content": "Welcome!",
      "dataType": "text",
      "size": 250,
      "format": "svg",
      "darkColor": "#1e40af",
      "lightColor": "#fbbf24"
    },
    {
      "content": "MyNetwork:MyPassword",
      "dataType": "wifi",
      "size": 400,
      "format": "png",
      "errorCorrectionLevel": "Q"
    }
  ],
  "outputFormat": "zip"
}

Branded QR Code with Logo

{
  "data": [
    {
      "content": "https://www.brand.com",
      "dataType": "url",
      "size": 500,
      "format": "png",
      "logo": "https://example.com/logo.png",
      "logoSize": 100,
      "darkColor": "#2563eb",
      "lightColor": "#ffffff"
    }
  ]
}