QR Code Detection & Decoding

Detect and decode QR codes from images via a single API call. Input an image (URL or base64), get structured output: decoded content, content type classification, position, and confidence.

When to Use

• You have a screenshot or photo and need to extract the QR code content
• A workflow requires reading a QR code from an image URL
• You need to classify what a QR code contains (URL, WiFi config, vCard, email, etc.)
• You need to batch-process multiple images for QR code extraction

API

Endpoint: POST https://data.cli.im/x-deepscan/vision/detect

Content-Type: application/json

Input — pick one

# From URL (simplest)
curl -s -X POST https://data.cli.im/x-deepscan/vision/detect \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/photo-with-qrcode.jpg"}'

# From local file (base64)
curl -s -X POST https://data.cli.im/x-deepscan/vision/detect \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 -i photo.jpg)\"}"

# Batch
curl -s -X POST https://data.cli.im/x-deepscan/vision/detect \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/1.jpg", "https://example.com/2.jpg"]}'

Output

Single image returns:

{
  "count": 1,
  "codes": [
    {
      "content": "https://example.com",
      "format": "QR Code",
      "content_type": "url",
      "bbox": {"x1": 211.8, "y1": 211.3, "x2": 425.8, "y2": 424.7},
      "keypoints": null,
      "confidence": 0.93
    }
  ]
}

No QR code found returns {"count": 0, "codes": []} — not an error.

Content Type Classification

content_type is auto-classified:

Request Fields Reference

All fields optional, but at least one required:

Single input (image or url alone) returns DetectResponse. Batch/mixed returns BatchDetectResponse with per-item results.

Error Handling

Errors return {"error": {"code": "...", "message": "..."}}.

Rate Limits

Free usage: 20 requests/minute, 200 requests/day per IP.

Limitations

• Optimized for 2D codes (QR Code, DataMatrix). 1D barcode detection (EAN-13, Code128) is weak in complex backgrounds.
• Max image size: 10MB. Supports JPEG, PNG, GIF, WebP, BMP.
• URL input has SSRF protection — private/internal network URLs are blocked.