Developer API Reference

Generate customized, high-quality QR codes dynamically using simple web requests. Optimized for speed and instant response times.

All requests are optimized for fast delivery and automatic caching. This guarantees instant load speeds when embedding QR codes directly in your website or emails.

Endpoints

QR Maker provides two endpoints to choose from depending on your integration needs.

Free Endpoint

Standard rate limits, no auth required.

Plus Endpoint

Higher rate limits, requires Bearer API Key.

Resources

Authentication & API Keys

For higher rate limits, authenticate your API requests by passing your API Key in the HTTP Authorization header using the Bearer scheme. Authenticated requests bypass the public rate limits, allowing up to 20 requests per 10 seconds.

Authorization: Bearer YOUR_API_KEY

Request an API Key

Generate a free API Key to authenticate your requests and access the high-limit endpoint of the QR Maker API. Keys are generated instantly and are valid for a limited duration.

To request your key, enter your email address and complete the security verification below. Once generated, be sure to copy the key immediately or email it to yourself for your records.

Query Parameters

Customize your generated QR codes by appending the following parameters to the URL query string.

Response Formats

Content-Type: image/png

Content-Type: image/svg+xml; charset=utf-8

{
  "data": "data:image/png;base64,iVBORw0KGgo..."
}

Interactive Playground

Construct your API request with parameters below and preview the generated QR code instantly in your browser.

Code Integration

Easy-to-use snippets to programmatically fetch, generate, or embed QR codes in your application workflows.

<img src="https://qrmaker.ryanmarch.me/api/qr?content=https%3A%2F%2Fqrmaker.ryanmarch.me&size=512&fgColor=327DFF" alt="QR Code" />

# Download a high-res custom SVG QR code using your API Key
curl -H "Authorization: Bearer YOUR_API_KEY" -o qr.svg "https://qrmaker.ryanmarch.me/api/plus?content=https%3A%2F%2Fqrmaker.ryanmarch.me&format=svg&fgColor=327DFF"

// Fetch Base64 data from the API using your API Key
fetch("https://qrmaker.ryanmarch.me/api/plus?content=https%3A%2F%2Fqrmaker.ryanmarch.me&format=base64", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY"
  }
})
  .then(res => res.json())
  .then(json => {
    console.log("Base64 Data URI:", json.data);
    // document.getElementById('my-img').src = json.data;
  });

// Example Node.js/Express proxy endpoint (/api/qr)
const express = require('express');
const fetch = require('node-fetch'); // or global fetch in Node 18+
const app = express();

app.get('/api/qr', async (req, res) => {
  // Construct the target URL with query parameters from the frontend
  const query = new URLSearchParams(req.query).toString();
  const targetUrl = `https://qrmaker.ryanmarch.me/api/plus?${query}`;

  try {
    const apiResponse = await fetch(targetUrl, {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY' // Stored securely on the server
      }
    });

    res.setHeader('Content-Type', apiResponse.headers.get('Content-Type'));
    apiResponse.body.pipe(res);
  } catch (err) {
    res.status(500).json({ error: 'Failed to proxy request to QR Maker' });
  }
});