Quick Start

Introduction

EasyOCR provides a simple RESTful API that allows you to quickly integrate OCR text recognition into your applications.

API Endpoint

International:

POST https://api.easyocr.org/ocr

China (faster for CN users):

POST https://cn-api.easyocr.org/ocr

Request Parameters

ParameterTypeRequiredDescription
fileFileYesImage file to recognize (JPG, PNG, BMP)

Code Examples

JavaScript

const formData = new FormData();
formData.append('file', fileInput.files[0]);

fetch('https://api.easyocr.org/ocr', {
  method: 'POST',
  body: formData
})
  .then(res => res.json())
  .then(data => console.log(data));

Python

import requests

files = {'file': open('image.jpg', 'rb')}
response = requests.post('https://api.easyocr.org/ocr', files=files)
print(response.json())

cURL

curl -X POST https://api.easyocr.org/ocr -F "file=@image.jpg"

Response Format

{
  "words": [
    {
      "text": "Recognized text",
      "left": 53.9,
      "top": 79.7,
      "right": 508.6,
      "bottom": 171.1,
      "rate": 0.998
    }
  ]
}

Need Help?

If you encounter any issues, please visit ourHelp Centerorcontact us