Free Online OCR Convert JPEG, PNG, GIF, BMP, TIFF, PDF, DjVu to Text

Authentication

Authentication in API is realized using keys. The API key is provided for every request and is passed as a query string parameter. Request your free personal API key by filling form at the bottom of this page.

Upload Files

You can upload JPEG, PNG, GIF, BMP and multipage TIFF, PDF, DJVU files.

To use multipart upload, make a POST request to the method's /v1/upload URI and add the query parameter key=api_key, for example:

POST /v1/upload?key=api_key HTTP/1.1
Host: api.newocr.com
Content-Type: multipart/form-data; boundary=---------------------------41184676334
Content-Length: 29278

-----------------------------41184676334
Content-Disposition: form-data; name="file"; filename="filename.jpg"
Content-Type: image/jpeg

(Binary data not shown)
-----------------------------41184676334--

If the request succeeds, the server returns the HTTP 200 OK status code along with any metadata:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "success",
  "data":
  {
    "file_id": "6fa11ac55c10ade5dd4d6126c34d1e08",
    "pages": 257
  }
}

Example: Curl upload

curl -H "Expect:" -F file=@./path/to/file http://api.newocr.com/v1/upload?key=api_key

Example: PHP upload

<?php
  $file = realpath('filename.tif');
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, 'http://api.newocr.com/v1/upload?key=api_key');
  curl_setopt($ch, CURLOPT_SAFE_UPLOAD, false);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
  curl_setopt($ch, CURLOPT_POST, TRUE);
  curl_setopt($ch, CURLOPT_POSTFIELDS, array('file' => '@'.$file));
  $result = curl_exec($ch);
  echo $result;
  curl_close ($ch);
?>

OCR

After uploading the file, you can recognize the page.

To use OCR, make a GET request to the method's /v1/ocr URI and add the query parameters, for example:

GET /v1/ocr?key=api_key&file_id=12345&page=1&lang=eng&psm=6 HTTP/1.1
Host: api.newocr.com

If the request succeeds, the server returns the HTTP 200 OK status code along with any metadata:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "success",
  "data":
  {
    "text": "Recognized text",
    "progress": "100"
  }
}

Query parameters

• file_id - file identifier obtained from /v1/upload
• page - page number in the multi-page documents such as PDF, TIFF, DJVU
• lang - language(s) used for OCR (allowed values are):

  aframharaasmazeaze_cyrlbelbenbodbosbrebulcatcebceschi_simchi_sim_vertchi_trachi_tra_vertchrcymdandan_frakdeudeu_frakdzoellengenmepoequesteusfasfinfrafrkfrmgleglggrcgujhathebhinhrvhunikuindislitaita_oldjavjpnjpn_vertkankatkat_oldkazkhmkirkorkor_vertkurkur_aralaolatlavlitltzmalmarmkdmltmonmrimsamyanepnldnorocioripanpolporpusqueronrussansinslkslk_frakslvsndspaspa_oldsqisrpsrp_latnsunswaswesyrtamtatteltgktglthatirtonturuigukrurduzbuzb_cyrlvieyidyor

• psm - page segmentation mode. Allowed values are:
  • 3 = Fully automatic page segmentation
  • 6 = Assume a single uniform block of text
• rotate - image rotation in degrees. Allowed values are: 0, 90, 180, 270

Example: Curl

curl "http://api.newocr.com/v1/ocr?key=api_key&file_id=123&page=1&lang=eng&psm=6"

Example: PHP

<?php
  $ch = curl_init('http://api.newocr.com/v1/ocr?key=api_key&file_id=123&page=1&lang=eng&psm=6');
  curl_setopt($ch, CURLOPT_HEADER, 0);
  $result = curl_exec($ch);
  echo $result;
  curl_close($ch);
?>

API key status

To get the status of your API key, make a GET request to the method's /v1/key/status URI and add the query parameters, for example:

GET /v1/key/status?key=api_key HTTP/1.1
Host: api.newocr.com

If the request succeeds, the server returns the HTTP 200 OK status code along with any metadata:

HTTP/1.1 200 OK
Content-Type: application/json
{
  "status": "success",
  "data":
  {
    "key_status": "paid",
    "paid_up_to": "2014-11-18 00:00:00",
    "ocrs_left": "96"
  }
}