# Qr Code Generator (`leadsbrary/qr-code-studio`) Actor Generate your Custom QR Code From 1$/1000. PNG & SVG output, 9 style presets (rounded, dots, neon, elegant…), custom label & logo overlay, Wi-Fi/vCard/URL payloads. Batch mode, ZIP download, REST API & Standby. No watermark. - **URL**: https://apify.com/leadsbrary/qr-code-studio.md - **Developed by:** [Alexandre Manguis](https://apify.com/leadsbrary) (community) - **Categories:** Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## QR Code Studio Generate stylish, branded QR codes from URLs, WiFi credentials, vCards, emails, SMS, phone numbers, geo links, and calendar events. Export as PNG, SVG, or a ready-to-use ZIP archive. Run as a standard Actor run or as a persistent Standby HTTP API. --- ### Style presets 9 ready-to-use visual styles — no design skills required. ![QR Code Style Previews](https://api.apify.com/v2/key-value-stores/wxcuhV4zPMQ4WMt2u/records/qr-styles-preview.png) | Preset | Look | |--------|------| | `classic` | Black and white, square modules | | `rounded` | Dark, soft rounded corners | | `dots` | Circular dots with circular eyes | | `elegant` | Subtle rounded modules on a light grey background | | `neon` | Cyan on dark navy, green eyes | | `soft` | Warm yellow background, teal modules, red eyes | | `inverted` | White modules on a dark background | | `terminal` | Green on black, monospace feel | | `brand` | Blue modules on white, brand-ready | --- ### Payload types | Type | What it encodes | |------|-----------------| | `raw` | Any plain text or URL as-is | | `url` | URL with optional `https://` normalization | | `wifi` | WiFi network credentials (SSID, password, encryption) | | `vcard` | Contact card (name, phone, email, website, company) | | `email` | Pre-filled email with recipient, subject, and body | | `sms` | Pre-filled SMS with phone number and message | | `phone` | Direct phone dial link | | `geo` | GPS coordinates and optional altitude | | `event` | iCalendar event (title, start, end, location, description) | --- ### Quick start #### Single QR code — URL ```json { "content": "https://apify.com", "size": 512, "format": "png", "stylePreset": "rounded" } ```` #### With a logo and label ```json { "content": "https://apify.com", "size": 768, "format": "both", "stylePreset": "elegant", "logoUrl": "https://cdn.apify.com/apify_favicon.png", "label": "Scan me", "labelPosition": "bottom" } ``` #### WiFi credentials ```json { "payloadType": "wifi", "payload": { "ssid": "Guest WiFi", "password": "change-me", "encryption": "WPA", "hidden": false }, "stylePreset": "soft", "size": 512 } ``` #### vCard contact ```json { "payloadType": "vcard", "payload": { "fullName": "Jane Doe", "organization": "Acme Corp", "title": "Founder", "phone": "+33123456789", "email": "jane@acme.com", "url": "https://acme.com" }, "stylePreset": "brand" } ``` #### Batch — multiple QR codes in one run ```json { "size": 768, "format": "both", "zipOutput": true, "requests": [ { "name": "website", "content": "https://acme.com", "stylePreset": "rounded" }, { "name": "wifi", "payloadType": "wifi", "payload": { "ssid": "Office", "password": "secret", "encryption": "WPA" }, "stylePreset": "dots" }, { "name": "contact", "payloadType": "vcard", "payload": { "fullName": "Jane Doe", "phone": "+33123456789", "email": "jane@acme.com" }, "stylePreset": "brand" } ] } ``` *** ### Input fields | Field | Type | Default | Description | |-------|------|---------|-------------| | `content` | string | — | Text or URL to encode. | | `requests` | array | — | Batch mode — one QR code per item; each item can override any field. | | `payloadType` | string | `raw` | `raw`, `url`, `wifi`, `vcard`, `email`, `sms`, `phone`, `geo`, or `event`. | | `payload` | object | — | Structured payload for non-raw types. | | `format` | string | `png` | `png`, `svg`, `both`, `dataUrl`, or `json`. | | `size` | integer | `512` | Output size in pixels (width and height). | | `margin` | integer | `4` | Quiet zone width. Keep `4` for best scanner compatibility. | | `errorCorrectionLevel` | string | `H` | `L`, `M`, `Q`, or `H`. Use `H` with a logo. | | `stylePreset` | string | `rounded` | One of the 9 style presets listed above. | | `foregroundColor` | string | preset | Module color. Hex recommended. | | `backgroundColor` | string | preset | Background color. | | `transparentBackground` | boolean | `false` | Transparent background (PNG/SVG). | | `moduleStyle` | string | preset | `square`, `rounded`, or `dots`. | | `eyeStyle` | string | preset | `square`, `rounded`, or `circle`. | | `logoUrl` | string | — | Public image URL for a center logo. | | `logoBase64` | string | — | Base64 or data URL logo. | | `logoSizeRatio` | number | `0.2` | Logo size relative to QR size (0.08–0.32). | | `logoBackgroundColor` | string | — | Color behind the logo (improves contrast). | | `label` | string | — | Short text above or below the QR code. | | `labelPosition` | string | `bottom` | `top` or `bottom`. | | `labelFontSize` | integer | auto | Font size for the label in pixels. | | `storeFiles` | boolean | `true` | Save PNG/SVG files to the key-value store. | | `includeBase64` | boolean | `false` | Embed data URLs directly in dataset rows. | | `zipOutput` | boolean | `true` | Bundle all files into a `QR_CODES_ZIP` archive. | | `zipFilename` | string | auto | Custom ZIP archive filename. | | `filenamePrefix` | string | `qr` | Prefix for all generated filenames. | | `normalizeUrl` | boolean | `true` | Auto-add `https://` to bare domains. | | `failOnError` | boolean | `false` | Stop the run on the first error (default: log and continue). | *** ### Output #### Dataset item (one row per QR code) ```json { "success": true, "index": 0, "requestId": "website", "content": "https://acme.com", "payloadType": "raw", "formats": ["png", "svg"], "size": 768, "width": 768, "height": 820, "stylePreset": "rounded", "pngFileName": "qr-0001-website.png", "pngUrl": "https://api.apify.com/v2/key-value-stores/.../records/...", "svgFileName": "qr-0001-website.svg", "svgUrl": "https://api.apify.com/v2/key-value-stores/.../records/...", "generatedAt": "2026-01-01T12:00:00.000Z" } ``` #### Key-value store records | Key | Content | |-----|---------| | `QR_0001_...` | Individual PNG or SVG file | | `OUTPUT` | JSON summary with total count and per-item status | | `QR_CODES_ZIP` | ZIP archive with all generated files (when enabled) | *** ### Standby HTTP API When run in Standby mode, the Actor exposes a persistent HTTP endpoint. Useful for integrations that need on-demand QR codes without running a full Actor job. #### Get an image directly ```bash curl "https://YOUR-STANDBY-URL/qr?content=https%3A%2F%2Fapify.com&format=png&stylePreset=rounded" --output qr.png ``` #### Get a JSON response ```bash curl -X POST "https://YOUR-STANDBY-URL/generate" \ -H "Content-Type: application/json" \ -d '{"content":"https://apify.com","format":"both","stylePreset":"brand"}' ``` #### Batch endpoint ```bash curl -X POST "https://YOUR-STANDBY-URL/batch" \ -H "Content-Type: application/json" \ -d '{"requests":[{"content":"https://apify.com"},{"content":"Hello"}]}' ``` *** ### Client examples #### JavaScript ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('YOUR_USERNAME/qr-code-studio').call({ content: 'https://apify.com', size: 512, format: 'both', stylePreset: 'rounded', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0].pngUrl); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("YOUR_USERNAME/qr-code-studio").call(run_input={ "content": "https://apify.com", "size": 512, "format": "both", "stylePreset": "rounded", }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["pngUrl"]) ``` *** ### Production tips - Use `errorCorrectionLevel: "H"` whenever you embed a logo — it allows the QR to remain scannable even with the logo covering part of the data. - Keep `margin` at `4` unless your design guarantees enough quiet zone around the code. - Always test transparent and custom-color QR codes with multiple phone cameras before printing. - For bulk runs, use `storeFiles: true` and `zipOutput: true` to download all files in one archive. - In batch mode, set `name` on each request for readable filenames and dataset rows. *** ### Keywords qr code generator, qr code apify, bulk qr codes, batch qr code, branded qr code, stylish qr code, qr code with logo, qr code png, qr code svg, qr code wifi, qr code vcard, qr code contact, qr code email, qr code sms, qr code geo, qr code calendar, qr code api, standby api, qr code zip, qr code dataset, qr code automation, qr code no-code, apify actor # Actor input Schema ## `content` (type: `string`): Text or URL to encode. Leave empty when using batch requests below. ## `stylePreset` (type: `string`): Visual design of the QR code. ## `format` (type: `string`): Output file format. ## `size` (type: `integer`): Output image size in pixels. ## `requests` (type: `array`): Generate multiple QR codes in one run. Each item can override content, style, format, payload, logo, and label. ## `payloadType` (type: `string`): Choose a structured type to encode WiFi, contacts, emails, etc. Use the Payload field below for the details. ## `payload` (type: `object`): JSON data for the selected payload type. WiFi example: {"ssid":"Guest WiFi","password":"secret","encryption":"WPA"}. vCard example: {"fullName":"Jane Doe","email":"jane@example.com","phone":"+33123456789"}. ## `logoUrl` (type: `string`): Public image URL to embed in the center of the QR code. ## `label` (type: `string`): Short text printed below (or above) the QR code. ## `labelPosition` (type: `string`): Where to place the label relative to the QR code. ## `zipOutput` (type: `boolean`): Bundle all generated files into a single downloadable ZIP. ## `errorCorrectionLevel` (type: `string`): H is recommended when using a logo. L is the most compact. ## Actor input object example ```json { "content": "https://apify.com", "stylePreset": "rounded", "format": "png", "size": 512, "payloadType": "raw", "labelPosition": "bottom", "zipOutput": true, "errorCorrectionLevel": "H" } ``` # Actor output Schema ## `results` (type: `string`): Dataset rows with one item per QR generation request. ## `summary` (type: `string`): JSON summary written to the OUTPUT key-value store record. ## `files` (type: `string`): All generated PNG, SVG, ZIP, and OUTPUT records in the default key-value store. ## `zip` (type: `string`): Downloadable ZIP archive containing generated QR files when zipOutput is enabled. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "content": "https://apify.com" }; // Run the Actor and wait for it to finish const run = await client.actor("leadsbrary/qr-code-studio").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "content": "https://apify.com" } # Run the Actor and wait for it to finish run = client.actor("leadsbrary/qr-code-studio").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "content": "https://apify.com" }' | apify call leadsbrary/qr-code-studio --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=leadsbrary/qr-code-studio", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Qr Code Generator", "description": "Generate your Custom QR Code From 1$/1000. PNG & SVG output, 9 style presets (rounded, dots, neon, elegant…), custom label & logo overlay, Wi-Fi/vCard/URL payloads. Batch mode, ZIP download, REST API & Standby. No watermark.", "version": "1.0", "x-build-id": "99FpG5Atctu2VEdnA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leadsbrary~qr-code-studio/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leadsbrary-qr-code-studio", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/leadsbrary~qr-code-studio/runs": { "post": { "operationId": "runs-sync-leadsbrary-qr-code-studio", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/leadsbrary~qr-code-studio/run-sync": { "post": { "operationId": "run-sync-leadsbrary-qr-code-studio", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "content": { "title": "Content", "type": "string", "description": "Text or URL to encode. Leave empty when using batch requests below." }, "stylePreset": { "title": "Style preset", "enum": [ "classic", "rounded", "dots", "elegant", "neon", "soft", "inverted", "terminal", "brand" ], "type": "string", "description": "Visual design of the QR code.", "default": "rounded" }, "format": { "title": "Format", "enum": [ "png", "svg", "both" ], "type": "string", "description": "Output file format.", "default": "png" }, "size": { "title": "Size (px)", "minimum": 64, "maximum": 4096, "type": "integer", "description": "Output image size in pixels.", "default": 512 }, "requests": { "title": "Batch requests", "type": "array", "description": "Generate multiple QR codes in one run. Each item can override content, style, format, payload, logo, and label.", "items": { "type": "object", "additionalProperties": true, "properties": { "name": { "title": "Name", "type": "string", "description": "Used for file names and dataset row ID.", "editor": "textfield" }, "content": { "title": "Content", "type": "string", "description": "Text or URL to encode.", "editor": "textarea" }, "payloadType": { "title": "Payload type", "type": "string", "description": "Payload type for this item.", "editor": "select", "default": "raw", "enum": [ "raw", "url", "wifi", "vcard", "email", "sms", "phone", "geo", "event" ], "enumTitles": [ "Raw text", "URL", "WiFi", "vCard", "Email", "SMS", "Phone", "Geo location", "Calendar event" ] }, "payload": { "title": "Structured payload", "type": "object", "description": "JSON data for the payload type. Example for WiFi: {\"ssid\":\"Guest\",\"password\":\"secret\",\"encryption\":\"WPA\"}.", "editor": "json" }, "stylePreset": { "title": "Style preset", "type": "string", "description": "Visual design for this QR code.", "editor": "select", "default": "rounded", "enum": [ "classic", "rounded", "dots", "elegant", "neon", "soft", "inverted", "terminal", "brand" ] }, "format": { "title": "Format", "type": "string", "description": "Output format for this QR code.", "editor": "select", "default": "png", "enum": [ "png", "svg", "both", "dataUrl", "json" ], "enumTitles": [ "PNG", "SVG", "PNG + SVG", "PNG data URL", "JSON + data URL" ] }, "size": { "title": "Size (px)", "type": "integer", "description": "Output image size in pixels.", "editor": "number", "minimum": 64, "maximum": 4096 }, "logoUrl": { "title": "Logo URL", "type": "string", "description": "Public image URL to embed in the center.", "editor": "textfield" }, "label": { "title": "Label", "type": "string", "description": "Short text printed below the QR code.", "editor": "textfield" } } } }, "payloadType": { "title": "Payload type", "enum": [ "raw", "url", "wifi", "vcard", "email", "sms", "phone", "geo", "event" ], "type": "string", "description": "Choose a structured type to encode WiFi, contacts, emails, etc. Use the Payload field below for the details.", "default": "raw" }, "payload": { "title": "Structured payload", "type": "object", "description": "JSON data for the selected payload type. WiFi example: {\"ssid\":\"Guest WiFi\",\"password\":\"secret\",\"encryption\":\"WPA\"}. vCard example: {\"fullName\":\"Jane Doe\",\"email\":\"jane@example.com\",\"phone\":\"+33123456789\"}." }, "logoUrl": { "title": "Logo URL", "type": "string", "description": "Public image URL to embed in the center of the QR code." }, "label": { "title": "Label text", "type": "string", "description": "Short text printed below (or above) the QR code." }, "labelPosition": { "title": "Label position", "enum": [ "top", "bottom" ], "type": "string", "description": "Where to place the label relative to the QR code.", "default": "bottom" }, "zipOutput": { "title": "Create ZIP archive", "type": "boolean", "description": "Bundle all generated files into a single downloadable ZIP.", "default": true }, "errorCorrectionLevel": { "title": "Error correction level", "enum": [ "L", "M", "Q", "H" ], "type": "string", "description": "H is recommended when using a logo. L is the most compact.", "default": "H" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```