General Barcode Generation
Generate scan-ready barcode images in 40 common formats
Bestseller
QR Code Barcode Tools Image Decoding
Decode QR Code from Image
Read QR code content from images
What can this API do?
Image QR reading
Read one QR code from a supported image.
Exact decoded text
Preserve spaces, line breaks and multilingual text.
Content categories
Identify website, Wi-Fi, email and text payloads.
Corner coordinates
Locate the decoded code within the image.
Upload or image link
Submit an image file or a public image URL.
Data-entry workflows
Connect QR reading to check-in and inventory apps.
Annual plan
$19$49
Try it for free!
Sign In Sign in to get a trial key and test all APIs.
Secure checkout powered by Stripe
API Document
HTTP Protocol:HTTPS
HTTP Method:POST
HTTP Endpoint:https://api.gugudata.io/v1/barcode/qrcode/decode
Response Type:application/json; charset=utf-8
DEMO Endpoint:https://api.gugudata.io/v1/barcode/qrcode/decode/demo
Live Demo:Try Interactive Demo
Full API Docs:developers.gugudata.io
API Request Parameters
| Name | Type | Is Required | Default Value | Remark |
|---|---|---|---|---|
| appkey | string | true | YOUR_APPKEY | Application key in the query string. |
| file | file | false | N/A | Exactly one of file or file_url. PNG, JPEG, static WebP or BMP; maximum 10 MiB, 8192 pixels per side and 16 million pixels. |
| file_url | string | false | https://gugudata.io/assets/demo/qrcode-decode-demo.png | Public HTTP(S) image URL, at most 2048 characters; mutually exclusive with file. |
API Response Parameters
| Name | Type | Remark |
|---|---|---|
| format | string | Always QR_CODE. |
| parsed | string | Exact decoded text, identical to raw. |
| points | array<array<number>> | Four [x, y] corners in top-left, top-right, bottom-right, bottom-left order; empty if unavailable. Coordinates use the original image dimensions. |
| raw | string | Exact decoded text without trimming or normalization. |
| type | string | URI, WIFI, EMAIL or TEXT. Decoded links are not visited. |
API Response Status Codes
| Status Code | Explanation of Status Code | Remarks |
|---|---|---|
| 200 | Request processed successfully. | Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`. |
| 400 | Invalid request parameters or request format. | Check required fields, data types, and request body format. |
| 401 | Missing or unknown application key. | Provide a valid `appkey` with the request. |
| 403 | The application key is recognized but access is not allowed. | The key may be expired, inactive, or not permitted for the requested API. |
| 413 | Image exceeds the file or pixel limit. | Use at most 10 MiB, 8192 pixels per side and 16 million pixels. |
| 422 | Image is unsupported or contains no readable QR code. | Use a clear PNG, JPEG, static WebP or BMP image. |
| 429 | Request rate or trial usage limit exceeded. | Reduce concurrency or retry after the limit window resets. |
| 500 | Internal service error. | Retry later or contact support if the error persists. |
| 502 | Image download or decoding failed. | Check the image link and try again later. |
| 503 | QR decoding is temporarily unavailable. | Try again later. |
Remote MCP
AI client access
Use this API through GuGuData Remote MCP
Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.
Endpoint
https://mcp.gugudata.io/mcpGeneric MCP configuration
{
"mcpServers": {
"gugudata": {
"url": "https://mcp.gugudata.io/mcp",
"transportType": "streamable-http"
}
}
}Code Snippets
Universal QR Code Generator
Create QR code images from text or URLs
Wi-Fi Wireless Network QR Code Generation
Generate a Wi-Fi QR code for quick network onboarding