Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
FREEDOM251

Freedom251 › Blog › document automation

PDF4me OCR Draft or High? Choose the Right Mode and Control API Usage

By Freedom251 Team · · 10 min read

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose Draft for a PDF that is already mostly searchable; choose High for a scan or image-only document. In PDF4me’s REST API, the two values select different processing paths, not points on a universal OCR accuracy scale. Draft is a light pass documented at one API call per file. High performs full recognition page by page and is documented at two API calls per page.

For files that mix born-digital pages with scans, pair either quality mode with ocrWhenNeeded set to the string "true". That lets the service skip pages that already contain searchable text. The setting is separate from qualityType, so selecting Draft or High alone does not describe how mixed pages will be handled.

As an Amazon Associate I earn from qualifying purchases.

Quick answer: which PDF4me OCR mode should you select?

PDF condition qualityType ocrWhenNeeded Documented API usage
Mostly born-digital, with a usable text layer Draft "true" when you want searchable pages skipped One API call per file
Scanned or image-only pages High "true" is still useful when some pages already contain text Two API calls per page
Mixed PDF containing both text and scans Choose the mode that matches the pages requiring recognition "true" to avoid reprocessing searchable pages Depends on how many pages require OCR

PDF4me requires the REST request field qualityType, and the documented choices are exactly Draft and High. Capitalization matters. The published call counts are usage figures, not accuracy scores: no percentage improvement, benchmark corpus, or character-error measurement is established for High versus Draft.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What the quality parameter actually controls

The word “quality” can suggest a slider from poor to excellent. That is not how this API is documented. qualityType tells PDF4me which OCR path to use for the input file.

#1 Best Overall
Sale
Epson Workforce ES-50 Compact & Lightweight Mobile Document Scanner | For Computers including PC and Mac Receipt and Document Scanner USB Powered
  • PORTABLE SCANNER FOR USE ON-THE-GO — The fastest and lightest mobile single-sheet-fed compact document scanner in its class¹
  • QUICK DOCUMENT SCANNING ― This Epson ultra-fast scanner scans a single page as quickly as 5.5 seconds²; Windows and Mac compatible
  • VERSATILE PAPER HANDLING ― Portable scanner scans documents up to 8.5 x 72 in; Also easily digitizes receipts and ID cards to make accounting, bookkeeping, and organizing simpler
  • INTUITIVE, HIGH-SPEED SOFTWARE — Epson ScanSmart Software³ is a smart tool allowing you to easily scan, review, and save; Stay organized easily with the help of this Epson scanner
  • EASY SETUP — USB-powered connect to your computer for quick and simple scanning; No batteries or external power supply required to operate portable document scanner; Standard Connectivity: USB 2.0

Draft is a light pass for normal PDFs

Draft is intended for a normal PDF that mostly has selectable text already. The service describes it as a light pass and publishes an allowance of one API call per file. It is therefore the practical first choice when the PDF’s text layer is intact and you are adding or repairing searchability rather than rebuilding every page from pixels.

A text layer can exist even when a page looks like a scan. Before choosing Draft, test the actual file: try selecting a sentence, copying it into a plain-text editor, and searching for a word that is visibly present. If copied text is empty, nonsensical, or missing on many pages, treat those pages as image-based instead of assuming that a visual PDF is searchable.

High performs full per-page recognition

High is built for scanned documents and image-based PDFs where every page needs recognition. PDF4me documents two API calls per page for this mode. That figure describes processing consumption, not a guaranteed accuracy level. High can be the appropriate path for a clean, high-resolution scan, but the result still depends on image quality, typography, page layout, language, and the source file.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Do not present High as “twice as accurate” because the two-call figure is not a test result. It only tells you how the service counts API usage for this path.

Why the two modes are not an accuracy ranking

The available PDF4me wording does not provide a measured character-accuracy benchmark comparing Draft and High. There is no supported percentage that tells you how many more characters High will recognize correctly. The meaningful distinction is whether the service should make a light pass over a mostly text-based file or perform recognition on each page’s image content.

“Draft costs 1 API call per file and suits normal PDFs. High costs 2 API calls per page and is built for scanned documents where every page needs recognition.”

Rank #2
Sale
Brother DS-640 Compact Mobile Document Scanner, (Model: DS640)
  • FAST SPEEDS - Scans color and black and white documents a blazing speed up to 16ppm (1). Color scanning won’t slow you down as the color scan speed is the same as the black and white scan speed.
  • ULTRA COMPACT – At less than 1 foot in length and only about 1. 5lbs in weight you can fit this device virtually anywhere (a bag, a purse, even a pocket).
  • READY WHENEVER YOU ARE – The DS-640 mobile scanner is powered via an included micro USB 3. 0 cable allowing you to use it even where there is no outlet available. Plug it into you PC or laptop and you are ready to scan.
  • WORKS YOUR WAY – Use the Brother free iPrint&Scan desktop app for scanning to multiple “Scan-to” destinations like PC, Network, cloud services, Email and OCR. (2) Supports Windows, Mac and Linux and TWAIN/WIA for PC/ICA for Mac/SANE drivers. (3)
  • OPTIMIZE IMAGES AND TEXT – Automatic color detection/adjustment, image rotation (PC only), bleed through prevention/background removal, text enhancement, color drop to enhance scans. Software suite includes document management and OCR software. (4)
— PDF4me OCR documentation

ocrWhenNeeded is a separate decision

ocrWhenNeeded controls whether PDF4me can leave an already-searchable page alone. In the REST examples, its value is a string: "true" or "false".

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • "true": skip pages that already have searchable text and OCR pages that need it.
  • "false": force OCR on every page, including pages that already contain a text layer.

Use "true" for mixed files when preserving good existing text matters and unnecessary processing would add cost or latency. Setting it to "false" is an explicit instruction to run OCR throughout the file; it is not a way to make Draft become High.

A single quality label does not automatically explain every mixed-page outcome. The skip control determines whether searchable pages are eligible to bypass OCR, while Draft or High determines the OCR path for pages that are processed.

Choose by document type, not by the label alone

Mostly born-digital PDF

  1. Open the file in a PDF viewer and select text from several pages, including tables and headings.
  2. Search for words that are visibly present and paste selected text into a plain-text editor to check whether characters survive correctly.
  3. Set qualityType to Draft.
  4. Set ocrWhenNeeded to "true" if pages with a valid text layer should be skipped.

This path aligns with PDF4me’s documented one-call-per-file usage for Draft. If the file contains a few pages that are actually images, the skip setting gives the service permission to avoid reprocessing pages that are already searchable.

Scanned or image-only PDF

  1. Check whether selecting text returns nothing or whether every page is effectively a picture.
  2. Set qualityType to High.
  3. Budget around the published two API calls per page. This is a planning figure from PDF4me, not a promise about completion time or recognition accuracy.
  4. Use ocrWhenNeeded set to "true" if the file also includes some pages with a reliable text layer.

High is the documented full per-page path for this input. If the scan is skewed, blurred, heavily compressed, or handwritten, changing the quality value cannot repair missing image information; improve the source scan or prepare for manual correction.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Mixed PDF

Mixed files are common in contracts, multipage submissions, and reports assembled from several sources. A text-based cover page may be followed by scanned exhibits. Set ocrWhenNeeded to "true" so searchable pages can be skipped, then select Draft or High according to the recognition path you need for the pages that are not searchable.

Rank #3
Plustek Mobile Scanner S410 Plus - Compact Portable Document Sheet-Fed | Support Windows 7 / 8 / 10 / 11, Featuring Button-Free Scanning with Included OCR Software. USB Powered
  • Digitize on the Go - Connect to your computer via BUS powered, eliminating the need for batteries or external power sources
  • Button Free Scanning Experience - The S410 Plus is an automatic scanning device, no need to push any buttons or click any screens, and automatically processes images and saves them to the designated folders
  • Versatile Paper Handling - Easily scan documents ranging from Letter and Legal sizes to business cards, plastic ID cards, invoices and receipts
  • Ultra compact & Lightweight - Weighing less than 1 lb, lighter than a bottle of mineral water, and its slim design is perfect for portability
  • Work smarter with Plustek Docaction - Built-in OCR allows you convert the files into editable, such as searchable PDF, excel or word. Seamless save to your local computer, FTP and even shared folder

Do not infer an exact call total without knowing how many pages the service decides require OCR. The published figures establish one call per file for Draft and two calls per page for High; they do not publish a universal mixed-document formula.

Build a correctly typed REST request

Many integration failures come from sending the right words with the wrong JSON types. PDF4me’s REST samples use strings for ocrWhenNeeded and outputFormat, but JSON booleans for isAsync and mergeAllSheets.

Field Type shown in REST samples What to check
qualityType String Use exactly Draft or High.
ocrWhenNeeded String Send quoted "true" or "false", not a JSON boolean, when following the REST shape.
outputFormat String Send the format as a quoted value accepted by the endpoint.
isAsync JSON boolean Use true or false without quotation marks.
mergeAllSheets JSON boolean Use true or false without quotation marks where this option applies.

Example payload shape

The following illustrates the types and the two quality choices. Replace the double-curly variables with values required by your implementation; they are shown inside code so the JSON shape remains unambiguous.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
{
  "qualityType": "Draft",
  "ocrWhenNeeded": "true",
  "outputFormat": "{{OUTPUT_FORMAT_STRING}}",
  "isAsync": false,
  "mergeAllSheets": false,
  "docContent": "{{BASE64_PDF}}"
}

For a scanned file, change only the quality decision to "High" unless your workflow requires different skip, language, or output settings:

{
  "qualityType": "High",
  "ocrWhenNeeded": "true",
  "outputFormat": "{{OUTPUT_FORMAT_STRING}}",
  "isAsync": false,
  "mergeAllSheets": false,
  "docContent": "{{BASE64_PDF}}"
}

Use the exact property names and required fields for the endpoint version you are calling. The important interoperability rule is not to “normalize” quoted values into booleans or vice versa.

When to use asynchronous processing

For large files or workloads that should not hold an HTTP connection open, use the endpoint’s asynchronous behavior. PDF4me documents a 202 response for an asynchronous job and a Location header containing the URL to poll.

Rank #4
Brother DS-740D Duplex Compact Mobile Document Scanner
  • FAST SPEED AND DUPLEX SCANNING – Scan single and double-sided documents in a single pass at up to 16 ppm(1). Color scanning doesn’t slow you down at all as it has the same scan speed as black and white document scanning.
  • ULTRA COMPACT – At less than 1 foot in length you can fit this device virtually anywhere (a bag, a purse, a pocket). The DSD (Desk Saving Design) feature reduces the amount of space needed to use the device, saving you 11 inches of desk space. (2)
  • READY WHENEVER YOU ARE – The DS-740D is powered via an included micro USB 3. 0 cable allowing you to use it even where there is no outlet available. Plug it into you PC or laptop and you are ready to scan.
  • WORKS YOUR WAY – Use the Brother free iPrint&Scan desktop app for scanning to multiple “Scan-to” destinations like PC, Network, cloud services, Email and OCR. (2) Supports Windows, Mac and Linux and TWAIN/WIA for PC/ICA for Mac/SANE drivers. (3)
  • OPTIMIZE IMAGES AND TEXT – Automatic color detection/adjustment, image rotation (PC only), bleed through prevention/background removal, text enhancement, color drop to enhance scans. Software suite includes document management and OCR software. (4)
  1. Submit the request with asynchronous processing enabled according to the endpoint’s documented option.
  2. When the response is 202 Accepted, read and store the Location URL.
  3. Poll that URL using the method and interval required by the API documentation.
  4. When the job is complete, parse the returned JSON and retrieve the output content.

Do not treat the 202 body as the finished PDF. It represents an accepted job; the polling URL is the next operation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recover the PDF from the response

The endpoint returns JSON containing the PDF as Base64 data rather than raw PDF bytes. Read the docContent field from the completed response, Base64-decode it, and write the resulting bytes as a PDF file. If your application saves the JSON text itself with a .pdf extension, the file will not open because it has not been decoded.

  1. Parse the HTTP response as JSON.
  2. Read the response’s docContent value.
  3. Decode the Base64 string using your language’s standard Base64 decoder.
  4. Write the decoded byte array to a binary file.
  5. Open the file and verify that text selection and search work before distributing it.

Set the source language when detection is wrong

Automatic language detection can produce garbled recognition. PDF4me advises supplying the source language when detection gets it wrong. In its REST examples, a full language name such as English is used.

Do not copy a language value from one integration into another without checking that surface’s schema. PDF4me’s cross-platform comparison shows examples in several forms: a full name such as English, a two-letter code such as en, or a three-letter code such as eng. The accepted representation can vary by connector. Send the format documented for the specific REST, Power Automate, n8n, Zapier, or Make interface you are using.

Language selection cannot compensate for a poor scan. If letters are missing because of blur, low contrast, or compression artifacts, correct the input image where possible and then rerun OCR.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Terminology changes across PDF4me integrations

PDF4me’s authored comparison maps the labels this way:

Best Value
CZUR Shine Ultra Smart Portable Document Scanner, Thin Book Scanner | OCR, USB Document Camera for Desktop/Laptop, Capture Size A3, Compatible with Windows & macOS
  • Design and Speed: Work with Windows XP/7/8/10/11 AND macOS 10.13 or later. Not compatible with Android and iOS. Designed for A3&A4(11.69*16.53 & 8.27*11.75 inch) document, any objects smaller than A3 size can be scanned with Ultra-fast scanning speed, about 1 second per page. Perfect device to scan FLAT papers
  • USB Document Camera & Scanner: Work as both a document camera for remote teaching&learning compatible with ZOOM; Goole Meet and a document scanner to scan papers and convert/OCR files. OCR supports 180+ languages for text recognition. Please note that Thai, Hebrew, and Arabic are currently not supported. If you need the complete OCR language support list, please feel free to contact us for more details
  • Patented Flattening Curved Book Page Technology: Shine Ultra applies CZUR’s patented technology to flatten the curved surface after pixel transformation to flattening of the book page (Only suitable for thinner books, ET series is recommended for thicker books)
  • High Resolution & AI Tech: CMOS 13MP (4160*3120, A4≈340 AND A3≈245 DPI) camera. Smart Paging and Auto Cropping; Combine Sides; Stamp Mode; and Multiple Color Modes
  • Height Adjustable & Portable: 2-level height adjustable neck. 90 degree foldable and lightweight 4 lbs with foot pedal for convenient operation
Integration surface Quality labels reported
REST Draft and High
Power Automate Draft and High
n8n Draft and High in the setting description
Zapier Standard and Expert
Make Standard and Expert

If a connector says Standard or Expert, do not send those words to a REST endpoint that requires Draft or High. Map the concept using that connector’s own documentation and field names.

The unexplained “Archival” value in n8n

The n8n response schema is reported to list Archival, while the setting description specifies only Draft and High. That mismatch does not establish a third selectable quality tier. Treat Archival as an unresolved schema discrepancy rather than a value to set in production.

Troubleshoot the failures that matter most

The API rejects qualityType

  • Check spelling and capitalization: the documented values are Draft and High.
  • Confirm that the request is going to the REST surface whose schema you are following; another connector may expose different labels.
  • Ensure the field is present rather than relying on an undocumented default.

The request fails type validation

  • Send ocrWhenNeeded as the quoted string "true" or "false" when using the REST shape.
  • Send isAsync and mergeAllSheets as JSON booleans, not quoted text.
  • Send outputFormat as a string accepted by the endpoint.

Searchable pages are processed again

Inspect ocrWhenNeeded. A value of "false" explicitly forces OCR on every page. Change it to "true" when the workflow should skip pages that already have searchable text.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The output looks like JSON instead of a PDF

Remember that the service returns Base64 inside JSON. Extract and decode docContent; do not save the response body directly as a PDF.

The job never returns a finished file

If the initial response is 202, follow the Location polling URL. A 202 response means the job was accepted asynchronously, not that the output is ready in that response.

Words are recognized as the wrong characters

  • Supply the source language in the format required by the integration.
  • Compare results from a representative page rather than judging the entire file from a title page.
  • Check scan resolution, skew, contrast, and compression before changing quality modes.

Plan usage without confusing it with price or accuracy

PDF4me publishes Draft at one API call per file and High at two API calls per page. These figures help estimate service consumption, but they are not a retail price, a time guarantee, or an OCR accuracy measurement. Your account’s billing terms, quotas, and any connector-specific accounting are separate questions.

For a 20-page scan processed with High, the documented planning figure is two calls per page, or 40 calls for that file. That arithmetic is a usage estimate based on the vendor’s published rule; it does not claim that every connector exposes or bills the calls identically. For a mostly searchable file using Draft, the published figure is one call for the file rather than one call for each page.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

On mixed documents, ocrWhenNeeded: "true" can reduce unnecessary processing by allowing searchable pages to be skipped. The exact total still depends on which pages require recognition and how the integration accounts for the operation.

A practical validation checklist

  • Confirm the PDF’s text layer on several representative pages.
  • Choose Draft for mostly searchable files and High for scan-heavy or image-only files.
  • Set ocrWhenNeeded to the quoted string "true" when searchable pages should be skipped.
  • Use the source-language format required by the integration if automatic detection is wrong.
  • Preserve the documented string-versus-boolean types.
  • Handle a 202 response by polling its Location URL.
  • Base64-decode docContent before saving the output PDF.
  • Verify search, copying, and a few difficult pages in the resulting file.

Bottom line

Draft and High are PDF4me processing choices tied to the character of your input, not universal OCR grades. Use Draft for a normal PDF with an existing text layer, High for scanned pages that need full recognition, and ocrWhenNeeded: "true" to avoid reprocessing pages that are already searchable. Treat the one-call and two-calls-per-page figures as vendor-published usage guidance, keep REST field types exact, and decode the Base64 result before treating the job as complete.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

document automationOCRPDFPDF4meREST API

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.