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.


    npm i ocr-space-api-alt2

    DownloadsWeekly Downloads






    Unpacked Size

    426 kB

    Total Files


    Last publish


    • anthonylzq