General Thai Document OCR

Reads a printed Thai or English document and returns its text, its layout, or a Word, PowerPoint, Excel or searchable PDF file made from it.

POST/v3/store/ocr/document/ocr

+5 endpoints

Try it

Price1 ICper page
Measured94.8%
Capacity15,400 pages/hour
Served418Kcalls

Input

OutputPOST /v3/store/ocr/document/ocr

text: ด่วนที่สุด ที่ มท ๐๔๐๒.๖ ...
time: 0.53
iapp: page: 1 char: 1376

The text is shown in part; the page has 1,376 characters.

Every field, under ResponseOther endpoints: /layout, /docx, /pptx, /xlsx, /searchablePDF see Request

Request

curl -X POST https://api.iapp.co.th/v3/store/ocr/document/ocr \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@document.pdf"

Response

200OK. The fields are explained under Response.

{
  "text": ["ด่วนที่สุด ที่ มท ๐๔๐๒.๖ ..."],
  "time": 0.53,
  "iapp": { "page": 1, "char": 1376 }
}

Request

multipart/form-data. Every endpoint takes the same fields and costs 1 IC per page; pick one by the output you want.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel. It is shown once.

Body

filefilerequired

The document: an image (PNG, JPEG), a PDF, or a Microsoft Office file (DOC, DOCX, XLS, XLSX, PPT, PPTX). Up to 30 MB. Not needed if base64 is sent.

base64string

One image as a Base64 string, instead of file.

emailstring

If set, the result is sent to this address instead of returned in the response.

Endpoint	Returns
`/v3/store/ocr/document/ocr`	Plain text, one string per page
`/v3/store/ocr/document/layout`	JSON: every component with its text, bounding box and type
`/v3/store/ocr/document/docx`	A link to a generated Word file
`/v3/store/ocr/document/pptx`	A link to a generated PowerPoint file
`/v3/store/ocr/document/xlsx`	A link to a generated Excel file
`/v3/store/ocr/document/searchablePDF`	A link to the original pages with a selectable text layer

The same endpoints answer under the legacy /document-ocr prefix.

Response

JSON, one shape per endpoint. The header iapp-input-pages carries the number of pages read, which is the number of IC charged.

The 38 component types

Group	Types
Titles and body	`CenTitle`, `Para1` to `Para5`, `BodyText3`, `Text`, `TextBox`
Lists	`List`, `ListNum1` to `ListNum4`, `ListCon1` to `ListCon4`
Indented blocks	`Indent1` to `Indent5`
Tables	`Table`, `TableLike`
Page furniture	`Header`, `Footer`, `Date`, `NextPage`, `UpperLeft`, `UpperRight`, `TopRight`, `BottomLeft`, `BottomRight`
Graphics	`Figure`, `Logo`, `LeftLogo`
Signatures	`Signature`

Details

Measured

On an independent public benchmark: 242 scanned pages from 20 Thai Administrative Court judgments, scored against the source documents with every difference counted, headers and typesetting included.

Measure	Result
Character error rate	5.2%, so 94.8% of characters correct
Word error rate	7.0%, so 93.0% of words correct
Layout analysis	96.97% AP
Median time, plain text	0.53 s per page
Sustained throughput	15,400 pages per hour, production, August 2026

Method, per-document results and a comparison with a leading cloud OCR service: the benchmark paper (PDF).

Limits

Printed text only; handwriting is not read.
Scans at 200 dpi or higher give the best results.

Data handling

Uploaded documents are used only to produce the requested output; generated links expire after 10 minutes and generated files are deleted within one hour. The service is GDPR and PDPA compliant. An on-premise deployment, in which no document leaves your network, is available: contact us.

Changelog

Version	Date	Changes
v2.1.13-20260822	22 Aug 2026	New engine (character error rate down 15% relative, median page time from 3.33 s to 0.53 s), signed expiring file links, on-premise deployment, and PowerPoint, Excel and searchable PDF out of preview.
v2.1.12-20251116	16 Nov 2025	Added the `iapp-input-pages` response header.
v2.0	Aug 2022	Document layout analysis and Word output.

Request​

Response​

Details​

Request

Response

Details