{
"openapi": "3.0.1",
"info": {
"title": "QR Code Generator API: Barcodes, EAN-13, SVG, PNG, PDF",
"description": "Bulk QR codes (URL, vCard, Wi-Fi, text) and barcodes (EAN-13, UPC-A, Code 128, DataMatrix) as SVG, PNG or PDF with colors, logo, URLs and a ZIP. No API key, no login. MCP-ready for Claude, Cursor, ChatGPT and AI agents. Pay per result, errors and duplicates are free. $0.50 per 1,000 codes.",
"version": "0.1",
"x-build-id": "pDhngbsFiBO8UR5X6"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/actose~qr-barcode-generator/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-actose-qr-barcode-generator",
"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/actose~qr-barcode-generator/runs": {
"post": {
"operationId": "runs-sync-actose-qr-barcode-generator",
"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/actose~qr-barcode-generator/run-sync": {
"post": {
"operationId": "run-sync-actose-qr-barcode-generator",
"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": {
"items": {
"title": "Codes to generate",
"type": "array",
"description": "One object per code. Required: \"data\" (or the structured fields below). Optional \"type\": url (default), text, vcard, wifi, email, phone, sms, geo, ean13, ean8, upca, code128, code39, itf, datamatrix. Optional per-item overrides: \"fileName\", \"format\", \"foregroundColor\", \"backgroundColor\", \"errorCorrection\", \"logoUrl\".
Wi-Fi: {\"type\":\"wifi\",\"ssid\":\"Cafe\",\"password\":\"secret\",\"security\":\"WPA\",\"hidden\":false}
vCard: {\"type\":\"vcard\",\"name\":\"Jane Doe\",\"phone\":\"+33612345678\",\"email\":\"jane@acme.com\",\"organization\":\"Acme\",\"title\":\"CEO\",\"website\":\"https://acme.com\",\"street\":\"1 rue de Paris\",\"city\":\"Paris\",\"zip\":\"75001\",\"country\":\"France\"}
Email: {\"type\":\"email\",\"to\":\"hi@acme.com\",\"subject\":\"Hello\",\"body\":\"...\"}
SMS: {\"type\":\"sms\",\"phone\":\"+33612345678\",\"message\":\"Hi\"}
Geo: {\"type\":\"geo\",\"lat\":48.8584,\"lng\":2.2945}
EAN-13 / EAN-8 / UPC-A: give 12/7/11 digits and the check digit is computed, or the full number and it is verified."
},
"dataLines": {
"title": "Quick list (one value per line)",
"type": "array",
"description": "Faster alternative for simple lists: each line becomes one code of the \"Default type\" below (e.g. a list of URLs, product numbers or serial numbers). Added after \"Codes to generate\".",
"items": {
"type": "string"
}
},
"defaultType": {
"title": "Default type",
"enum": [
"url",
"text",
"vcard",
"wifi",
"email",
"phone",
"sms",
"geo",
"ean13",
"ean8",
"upca",
"code128",
"code39",
"itf",
"datamatrix"
],
"type": "string",
"description": "Type used when an item has no \"type\" (and for every line of the quick list).",
"default": "url"
},
"format": {
"title": "File format",
"enum": [
"png",
"svg",
"pdf"
],
"type": "string",
"description": "SVG (vector, smallest, best for print and web), PNG (raster image) or PDF (vector, one page per code, ready to print).",
"default": "png"
},
"foregroundColor": {
"title": "Code color",
"type": "string",
"description": "Color of the dark modules / bars: #RRGGBB, #RGB or a CSS color name. Keep it dark for reliable scanning.",
"default": "#000000"
},
"backgroundColor": {
"title": "Background color",
"type": "string",
"description": "#RRGGBB, #RGB, a CSS color name, or \"transparent\" (PNG/SVG/PDF without background).",
"default": "#ffffff"
},
"errorCorrection": {
"title": "QR error correction",
"enum": [
"L",
"M",
"Q",
"H"
],
"type": "string",
"description": "How much of the QR code can be damaged and still scan: L ~7%, M ~15%, Q ~25%, H ~30%. Raised automatically to Q/H when a logo is used. Also raised for free when it does not make the code bigger.",
"default": "M"
},
"logoUrl": {
"title": "Logo URL (QR codes only)",
"type": "string",
"description": "Public URL of a PNG, JPEG, WebP or GIF image (max 5 MB) placed in the center of every QR code. Can be overridden per item with \"logoUrl\". Downloaded once per run."
},
"logoSizeRatio": {
"title": "Logo size",
"enum": [
"0.15",
"0.2",
"0.22",
"0.25",
"0.3"
],
"type": "string",
"description": "Logo width as a share of the QR code width (0.10 to 0.30). Larger logos look better but scan less reliably.",
"default": "0.22"
},
"moduleSize": {
"title": "QR / DataMatrix module size (px)",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Size of one square module in pixels. A typical QR code is 25–57 modules wide, so 10 px gives roughly 330–650 px images.",
"default": 10
},
"barWidth": {
"title": "Barcode bar width (px)",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "Width of the thinnest bar of 1D barcodes in pixels.",
"default": 3
},
"barHeight": {
"title": "Barcode height (px)",
"minimum": 10,
"maximum": 2000,
"type": "integer",
"description": "Height of the bars of 1D barcodes in pixels (text not included).",
"default": 100
},
"showText": {
"title": "Show human-readable text under barcodes",
"type": "boolean",
"description": "Print the encoded number/text under 1D barcodes (EAN, UPC, Code 128, Code 39, ITF).",
"default": true
},
"quietZone": {
"title": "Quiet zone (modules)",
"minimum": 0,
"maximum": 40,
"type": "integer",
"description": "Blank margin around the code, in modules. Leave empty for the standard: 4 for QR, 2 for DataMatrix, 10 for barcodes."
},
"fileNamePrefix": {
"title": "File name prefix",
"type": "string",
"description": "Optional prefix added to every file key, e.g. \"campaign-oct\" gives campaign-oct-00001-url.png."
},
"createZip": {
"title": "Also create one ZIP with all files",
"type": "boolean",
"description": "Stores codes.zip in the key-value store with every generated file (free, not charged).",
"default": true
},
"maxItems": {
"title": "Maximum codes to generate",
"minimum": 0,
"maximum": 100000,
"type": "integer",
"description": "Safety cap for this run. 0 = no cap (hard limit 100,000 per run).",
"default": 0
}
}
},
"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
},
"PROXY_UNBLOCKER_UNITS": {
"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
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}