Image to Text OCR
Scanned PDF, Per Line
Example request
curl -X POST https://radarbg.com/v1/image-pdf-ocr \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"urls": ["https://www.gutenberg.org/cache/epub/11/pg11.cover.medium.jpg", "https://www.gutenberg.org/cache/epub/84/pg84.cover.medium.jpg", "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"], "languages": ["eng"], "outputMode": "lines", "maxPagesPerPdf": 20}'
Answer: {"ok": true, "count": N, "items": [...], "usage": {...}}. Failed calls are not counted.
Inputs
| Field | Type | Description |
|---|---|---|
urls | array | Direct links to images (png, jpg, webp, tiff, bmp, gif) or PDF files, scanned or digital. One result row is produced per image and per PDF page. Links must be public and point straight to the file. |
languages | array | Languages of the text in your images. Pick one, or several for mixed text (a little slower). Used only when a page has to be read by OCR. |
outputMode | string | lines = every text line with its confidence and bounding box. words = every single word with confidence and bounding box (bigger output). |
maxPagesPerPdf | integer | Read at most this many pages from each PDF (from the first page). You pay per page, so this caps the cost of big documents. |
forceOcr | boolean | By default, PDF pages that already contain a text layer are read from it (fast, exact). Turn this on to run OCR on every page anyway, for example when the text layer is wrong. |
onlyNew | boolean | Skip every image or PDF URL that was already processed in an earlier run with the same Monitor ID. Use it for recurring jobs on a folder or feed of files. Each file is paid for once. |
monitorId | string | Separate memory for each watch list (used with only-new mode). Use a different ID per feed or customer. |
datasetId | string | Optional. Pick a dataset (or paste its ID) to read the input from, for example the result of Google Maps Scraper. When this actor runs as an integration, the dataset of the triggering run is used automatically (payload.resource.defaultDatas |
datasetField | string | Optional. The item field that holds the value, for example website, url or videoUrl (dot paths like author.url work). Empty = detected automatically. |
datasetMaxItems | integer | Upper limit of unique values taken from the dataset, to keep the cost under control. |
Price
Included in every plan: 100 calls a month free, then from €9 a month for 3,000 calls across all APIs.