space ocr
GuidesArticlesPricingDocs
Image OCR

Image OCR that returns structured fields, not a wall of text

Run OCR on JPEG, PNG, and other images with space-ocr: built-in templates, line items, CSV/JSON export, and every value returned with its box and a match score.

Most image OCR hands you a wall of plain text and stops there. You snap a receipt, run it, and get back a blob of lines you still have to read, split, and retype into the right columns. The structure that was obvious to your eye on the page is gone.

space-ocr reads an image into structured fields instead — store name here, date there, total over there, line items as rows. And it returns every value with the exact spot on the image it was read from: a box you can see, plus a score for how well it matched the pixels. So you don't have to trust the extraction; you can look at the photo and check it.

See a real extraction you can check

This is one image — a photo of two receipts — read into fields. Hover any value below and the box on the image is exactly where it was read. Every number, box, and match score here comes straight from a real parsed result, not a mockup.

Receipts with extracted-field bounding boxes
Verified fields
KINSHO · 合計 2,045
ライフ · 合計 4,286

Each value with a box carries a verified on-page location — bbox + 4-point vertices + match_ratio — on a 0–1000 normalized grid (0,0 top-left → 1000,1000 bottom-right), the same shape the live API returns. Hover a field to trace it back to the pixels it came from.

Structured fields, not a text dump
An image comes back as named fields and rows — store, date, total, line items — ready for a spreadsheet, instead of one long string you have to split yourself.
Every value located
Each field returns a bounding box (xmin/ymin/xmax/ymax on a 0–1000 grid), four oriented vertices, and a match_ratio — so a value traces back to the exact spot on the image.
Phone photos welcome
EXIF rotation is applied on load so the returned coordinates line up with the image you see, and the oriented boxes follow the tilt of a handheld shot.
Built-in templates
Apply a receipt, invoice, delivery note, business card, or driver license template with one templateId — or define your own fields.
Line items, not just totals
Tables come back as repeating rows with a position for every cell, even when a line wraps or merges on a crowded image.
Clean exports
CSV with a UTF-8 BOM (Excel- and CJK-safe, line items unfolded) and JSON over a REST API with async jobs and signed webhooks.

How image OCR works in space-ocr

Send an image to /ocr/fields as a URL or as plain base64 — JPEG, PNG, GIF, BMP, TIFF, and WebP are all read directly. EXIF orientation is applied when the image loads, so the boxes you get back match the photo as displayed, even from a phone held at an angle.

You don't have to write a schema for common documents. Pass a built-in templateId like receipt or invoice, or define your own fields — including an array field whose children describe one line-item row. (PDFs go through the web app, which renders each page to an image first; the API itself reads images.)

extract fields from an image
1
2
3
4
5
6
7
8
curl -s https://api.space-ocr.com/ocr/fields \
  -H "Authorization: Bearer $SPACE_OCR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://example.com/receipt-photo.jpg",
    "imageType": "url",
    "templateId": "receipt"
  }'

How to OCR an image

  1. Send your image
    Post a JPEG, PNG, GIF, BMP, TIFF, or WebP to /ocr/fields as a URL or plain base64, or drop it into the app. EXIF rotation is applied on load.
  2. Pick a template or fields
    Pass a built-in templateId like 'receipt' or 'invoice', or supply your own fields — including an array field with children for line-item tables.
  3. Read the structured result
    Each value returns with its bbox, vertices, match_ratio, and bbox_source, plus a field_bboxes map locating every field on the image.
  4. Verify anything
    Click a value to highlight the exact region it was read from; a match_ratio below 0.85 flags a value worth a closer look. Edits are stored beside the original OCR value.
  5. Export or query
    Download CSV (UTF-8 BOM, line items unfolded) or query a stored sheet with GET /view using where, sort, and select — no re-OCR, no extra charge.

Simple, predictable pricing

Pay $0.05 per image (¥10 / ₩100), with a free tier of 100 scans a month and no credit card. Flat plans add monthly scans, more sheets, and storage.

Free
$0
  • 100 scans / month
  • 3 sheets
  • 1 GB storage
Free — no card
Starter
$19/mo
  • 400 scans / month
  • 10 sheets
  • 10 GB storage
Start free
Most popular
Pro
$49/mo
  • 1,100 scans / month
  • Unlimited sheets
  • 100 GB storage
Start free
What image formats can space-ocr OCR?
The public API reads raster images directly — JPEG, PNG, GIF, BMP, TIFF, and WebP. Images are converted to RGB automatically. PDFs go through the web app, which renders each page to an image before OCR.
Does image OCR give me structured fields or just text?
Structured fields. An image is read into named values and rows — store, date, total, line items — each with its own location, rather than one long block of plain text you have to parse yourself.
Can I OCR a photo taken on my phone?
Yes. EXIF orientation is applied when the image loads, so the returned coordinates match the photo as displayed, and the oriented bounding boxes follow the tilt of a handheld shot. A slightly skewed photo still lines up.
Does image OCR keep the location of each value?
Yes. Every value comes back with a bounding box (xmin/ymin/xmax/ymax on a 0–1000 normalized grid), four oriented vertices, and a match_ratio. A match_ratio of 0.85 or higher is treated as a confident match, and 1.0 means every character was located on the image.
How do I send the image to the API?
Send it to POST /ocr/fields as a URL (imageType 'url') or as plain base64 (imageType 'base64', no data-URI prefix). Authenticate with a Bearer token; keys are prefixed spocr_. Pass a built-in templateId or your own fields.
How much does image OCR cost?
$0.05 per image (¥10 / ₩100), with a free tier of 100 scans a month and no credit card. Flat plans (Starter and Pro) add monthly scans, more sheets, and storage — see the plans above.

Turn your own images into checkable data

Free tier — 100 scans a month, no credit card. Every value comes back with its on-image location.

Related