TypeScript icon, indicating that this package has built-in type declarations

2.0.1 • Public • Published


Allow to access ORC.SPACE API to send images and get the embedded text.

More Details: https://ocr.space/ocrapi.


The OCR is provided by OCR.SPACE. I don't have anything with them, I just want to help reworking and sharing this library.

Main changes

  1. The original library was using request, but since it's deprecated, I saw the necessity to migrate from it. Now I'm currently using axios to perform the request.

  2. Since axios doesn't support form data request, I've used query-string.


First - Register and Get your API key

Get you API key at this link. Just follow their steps.

Second - Install npm package

  npm i ocr-space-api-alt2
  yarn add ocr-space-api-alt2

Usage example

You can see and example at the folder example.

const ocrSpaceApi = require('ocr-space-api-alt2')

const options =  { 
  apikey: '<YOUR API KEY HERE>',
  filetype: 'png',
  verbose: true,
  url: `${__dirname}/loveText.jpg`

const getText = async () => {
  try {
    const result = await ocrSpaceApi(options)

    console.log({ result })
  } catch (error) {



The available options are an adaptation from the docs.

key Value Description
apikey [Required] - String
API key from OCR space API
Get you API key at this link.
url [Required] - String
Url that points to file you want to get its text from. It can be a url (starting in http), a base64 image or a local file
language [Optional] - String
Croatian = hrv
Czech = cze
Danish = dan
Dutch = dut
English = eng
Finnish = fin
French = fre
German = ger
Greek = gre
Hungarian = hun
Korean = kor
Italian = ita
Japanese = jpn
Polish = pol
Portuguese = por
Russian = rus
Slovenian = slv
Spanish = spa
Swedish = swe
Turkish = tur
Language used for OCR. If no language is specified, English eng is taken as default.

IMPORTANT: The language code has always 3-letters (not 2). So it is "eng" and not "en".

Engine2 has automatic Western language detection, so this value will be ignored.
isOverlayRequired [Optional] - Boolean Default = False
If true, returns the coordinates of the bounding boxes for each word. If false, the OCR'ed text is returned only as a text block (this makes the JSON reponse smaller). Overlay data can be used, for example, to show text over the image.
filetype [Optional] - String
Available values: PDF, GIF, PNG, JPG, TIF, BMP
Overwrites the automatic file type detection based on content-type. Supported image file formats are png, jpg (jpeg), gif, tif (tiff) and bmp. For document ocr, the api supports the Adobe PDF format. Multi-page TIFF files are supported.
detectOrientation [Optional] - Boolean If set to true, the api autorotates the image correctly and sets the TextOrientation parameter in the JSON response. If the image is not rotated, then TextOrientation=0, otherwise it is the degree of the rotation, e. g. "270".
isCreateSearchablePdf [Optional] - Boolean Default = False
If true, API generates a searchable PDF. This parameter automatically sets isOverlayRequired = true.
isSearchablePdfHideTextLayer [Optional] - Boolean Default = False.
If true, the text layer is hidden (not visible).
scale [Optional] - Boolean Default = False.
If set to true, the api does some internal upscaling. This can improve the OCR result significantly, especially for low-resolution PDF scans. Note that the front page demo uses scale=true, but the API uses scale=false by default. See also this OCR forum post.
isTable [Optional] - Boolean If set to true, the OCR logic makes sure that the parsed text result is always returned line by line. This switch is recommended for table OCR, receipt OCR, invoice processing and all other type of input documents that have a table like structure.
OCREngine [Optional] - Number
Available values: 1, 2
Engine 1 is default. See OCR Engines.
verbose [Optional] - Boolean Wether or not you want the full response from de OCR API or just the text that was gotten.


  • Denis - Initial Work - Initial Documentation - dennnisk.
  • Anthony Luzquiños - Rework - AnthonyLzq.


This package was not fully tested, and every contribution will be appreciated.

Package Sidebar


npm i ocr-space-api-alt2

Weekly Downloads






Unpacked Size

426 kB

Total Files


Last publish


  • anthonylzq