{"openapi":"3.1.0","info":{"title":"OCR API","version":"1.0.0","description":"Extract text from images with optical character recognition in eight languages (English, German, French, Spanish, Italian, Portuguese, Dutch and Turkish). Get the full recognised text with an average confidence score and word and line counts, or word-level results where every word carries its own confidence and bounding box for layout-aware processing. Supply an image by public URL, base64 or a raw binary request body; large images are downscaled automatically before recognition to keep responses fast, and a warm engine keeps latency low after start-up. Pure server-side computation (Tesseract, no third-party upstream, no per-call cloud cost). Ideal for digitising documents and receipts, reading text from photos and screenshots, accessibility, and data-entry automation.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ocr-api","description":"oanor gateway"}],"tags":[{"name":"OCR"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/languages":{"get":{"operationId":"get_v1_languages","tags":["OCR"],"summary":"Supported OCR languages","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":8,"languages":[{"code":"eng","name":"English"},{"code":"deu","name":"German"},{"code":"fra","name":"French"},{"code":"spa","name":"Spanish"},{"code":"ita","name":"Italian"},{"code":"por","name":"Portuguese"},{"code":"nld","name":"Dutch"},{"code":"tur","name":"Turkish"}]},"meta":{"timestamp":"2026-05-30T22:48:29.088Z","request_id":"582efda3-2377-4cb1-b35e-810db5332469"},"status":"ok","message":"Languages retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ocr":{"get":{"operationId":"get_v1_ocr","tags":["OCR"],"summary":"Recognize text from an image","description":"","parameters":[{"name":"url","in":"query","required":false,"description":"Image URL to OCR (or send base64 / raw image body instead)","schema":{"type":"string"},"example":""},{"name":"base64","in":"query","required":false,"description":"Base64 image data (alternative to url)","schema":{"type":"string"},"example":"iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAAZElEQVR42u3QQREAAAgDoPUPuhqaw5MHBUjb+SwCBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIEDAfQsbYRN2hzEcHgAAAABJRU5ErkJggg=="},{"name":"lang","in":"query","required":false,"description":"eng|deu|fra|spa|ita|por|nld|tur","schema":{"type":"string"},"example":"eng"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"text":"Mild Splendour of the various-vested Night!\nMother of wildly-working visions! hail\nI watch thy gliding, while with watery light\nThy weak eye glimmers through a fleecy veil;\nAnd when thou lovest thy pale orb to shroud\nBehind the gather’d blackness lost on high;\nAnd when thou dartest from the wind-rent cloud\nThy placid lightning o’er the awaken’d sky.","language":"eng","confidence":92,"line_count":8,"word_count":58},"meta":{"timestamp":"2026-05-31T02:37:14.816Z","request_id":"8125c00b-8fba-46f3-a42b-34cb489fc6bc"},"status":"ok","message":"Text recognized","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/words":{"get":{"operationId":"get_v1_words","tags":["OCR"],"summary":"Word-level boxes & confidence","description":"","parameters":[{"name":"url","in":"query","required":false,"description":"Image URL to OCR (or send base64 / raw image body instead)","schema":{"type":"string"},"example":""},{"name":"base64","in":"query","required":false,"description":"Base64 image data (alternative to url)","schema":{"type":"string"},"example":"iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAAZElEQVR42u3QQREAAAgDoPUPuhqaw5MHBUjb+SwCBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIECAAAECBAgQIEDAfQsbYRN2hzEcHgAAAABJRU5ErkJggg=="},{"name":"lang","in":"query","required":false,"description":"Language code","schema":{"type":"string"},"example":"eng"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":58,"words":[{"bbox":{"x0":38,"x1":167,"y0":34,"y1":85},"text":"Mild","confidence":96.5},{"bbox":{"x0":198,"x1":477,"y0":36,"y1":104},"text":"Splendour","confidence":96.8},{"bbox":{"x0":504,"x1":559,"y0":37,"y1":88},"text":"of","confidence":97},{"bbox":{"x0":584,"x1":671,"y0":37,"y1":91},"text":"the","confidence":93.3},{"bbox":{"x0":698,"x1":1091,"y0":40,"y1":93},"text":"various-vested","confidence":92.4},{"bbox":{"x0":1119,"x1":1294,"y0":40,"y1":111},"text":"Night!","confidence":96.2},{"bbox":{"x0":105,"x1":304,"y0":111,"y1":162},"text":"Mother","confidence":95.5},{"bbox":{"x0":331,"x1":385,"y0":112,"y1":163},"text":"of","confidence":93.3},{"bbox":{"x0":411,"x1":824,"y0":112,"y1":184},"text":"wildly-working","confidence":91.9},{"bbox":{"x0":851,"x1":1048,"y0":116,"y1":167},"text":"visions!","confidence":96.5},{"bbox":{"x0":1077,"x1":1195,"y0":116,"y1":168},"text":"hail","confidence":36.1},{"bbox":{"x0":34,"x1":62,"y0":185,"y1":235},"text":"I","confidence":96.5},{"bbox":{"x0":87,"x1":253,"y0":185,"y1":236},"text":"watch","confidence":95.9},{"bbox":{"x0":282,"x1":371,"y0":186,"y1":255},"text":"thy","confidence":96.6},{"bbox":{"x0":398,"x1":603,"y0":187,"y1":257},"text":"gliding,","confidence":96.9},{"bbox":{"x0":632,"x1":780,"y0":189,"y1":242},"text":"while","confidence":96.7},{"bbox":{"x0":808,"x1":930,"y0":191,"y1":242},"text":"with","confidence":96.9},{"bbox":{"x0":957,"x1":1144,"y0":201,"y1":261},"text":"watery","confidence":97},{"bbox":{"x0":1171,"x1":1300,"y0":192,"y1":262},"text":"light","confidence":96.9},{"bbox":{"x0":101,"x1":213,"y0":260,"y1":328},"text":"Thy","confidence":96.5},{"bbox":{"x0":245,"x1":388,"y0":261,"y1":313},"text":"weak","confidence":96.5},{"bbox":{"x0":420,"x1":513,"y0":281,"y1":331},"text":"eye","confidence":93.3},{"bbox":{"x0":546,"x1":796,"y0":265,"y1":333},"text":"glimmers","confidence":92.6},{"bbox":{"x0":830,"x1":1047,"y0":266,"y1":336},"text":"through","confidence":96.7},{"bbox":{"x0":1080,"x1":1112,"y0":286,"y1":319},"text":"a","confidence":93.2},{"bbox":{"x0":1144,"x1":1303,"y0":268,"y1":338},"text":"fleecy","confidence":92.2},{"bbox":{"x0":1334,"x1":1454,"y0":267,"y1":331},"text":"veil;","confidence":94.4},{"bbox":{"x0":32,"x1":149,"y0":336,"y1":386},"text":"And","confidence":95.9},{"bbox":{"x0":172,"x1":320,"y0":336,"y1":388},"text":"when","confidence":96.5},{"bbox":{"x0":346,"x1":469,"y0":338,"y1":390},"text":"thou","confidence":93.2},{"bbox":{"x0":493,"x1":651,"y0":340,"y1":391},"text":"lovest","confidence":92.3},{"bbox":{"x0":675,"x1":764,"y0":342,"y1":409},"text":"thy","confidence":96.8},{"bbox":{"x0":788,"x1":902,"y0":343,"y1":410},"text":"pale","confidence":96.7},{"bbox":{"x0":927,"x1":1016,"y0":343,"y1":394},"text":"orb","confidence":96.3},{"bbox":{"x0":1042,"x1":1095,"y0":352,"y1":395},"text":"to","confidence":96.9},{"bbox":{"x0":1119,"x1":1308,"y0":344,"y1":395},"text":"shroud","confidence":96.8},{"bbox":{"x0":99,"x1":296,"y0":412,"y1":464},"text":"Behind","confidence":96.8},{"bbox":{"x0":321,"x1":408,"y0":414,"y1":466},"text":"the","confidence":93.2},{"bbox":{"x0":434,"x1":659,"y0":416,"y1":483},"text":"gather’d","confidence":70.9},{"bbox":{"x0":684,"x1":943,"y0":417,"y1":470},"text":"blackness","confidence":96.3},{"bbox":{"x0":968,"x1":1065,"y0":418,"y1":470},"text":"lost","confidence":96.7},{"bbox":{"x0":1090,"x1":1156,"y0":438,"y1":471},"text":"on","confidence":96.8},{"bbox":{"x0":1179,"x1":1323,"y0":419,"y1":489},"text":"high;","confidence":96.6},{"bbox":{"x0":28,"x1":144,"y0":487,"y1":537},"text":"And","confidence":93.8},{"bbox":{"x0":170,"x1":320,"y0":488,"y1":539},"text":"when","confidence":95.9},{"bbox":{"x0":345,"x1":468,"y0":490,"y1":541},"text":"thou","confidence":93.2},{"bbox":{"x0":497,"x1":685,"y0":492,"y1":543},"text":"dartest","confidence":90.6},{"bbox":{"x0":711,"x1":839,"y0":493,"y1":544},"text":"from","confidence":96.8},{"bbox":{"x0":866,"x1":953,"y0":494,"y1":546},"text":"the","confidence":93.3},{"bbox":{"x0":978,"x1":1250,"y0":495,"y1":547},"text":"wind-rent","confidence":92.1},{"bbox":{"x0":1275,"x1":1428,"y0":494,"y1":548},"text":"cloud","confidence":96.8},{"bbox":{"x0":96,"x1":208,"y0":563,"y1":632},"text":"Thy","confidence":96.7},{"bbox":{"x0":231,"x1":403,"y0":564,"y1":634},"text":"placid","confidence":96.2},{"bbox":{"x0":427,"x1":675,"y0":566,"y1":639},"text":"lightning","confidence":93.2},{"bbox":{"x0":700,"x1":800,"y0":568,"y1":621},"text":"o’er","confidence":89.5},{"bbox":{"x0":824,"x1":911,"y0":569,"y1":638},"text":"the","confidence":93.3},{"bbox":{"x0":935,"x1":1195,"y0":569,"y1":623},"text":"awaken’d","confidence":80.3},{"bbox":{"x0":1218,"x1":1324,"y0":569,"y1":640},"text":"sky.","confidence":96.1}],"language":"eng","confidence":92},"meta":{"timestamp":"2026-05-31T02:37:16.064Z","request_id":"b888e165-8811-4016-ae1b-66a7f657c94b"},"status":"ok","message":"Words recognized","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":1,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1250,"monthly_call_quota":40000,"rps_limit":3,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3400,"monthly_call_quota":250000,"rps_limit":8,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8900,"monthly_call_quota":1200000,"rps_limit":20,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ocr-api"}