While Reducto has a lot of capabilities, the most basic workflow is uploading a document and getting the parsed output for it. The easiest way to access our APIs is through our SDKs, available in Python and Node.js/Javascript.

Python SDK

Reducto for Python, our most popular option.

Node.js SDK

Reducto for Javascript and Node.js.
Need help finding your API Key? Find them in your account under “API Keys” at auth.reducto.ai.

​
Use the Reducto SDKs

1

Install the SDK

pip install reductoai
2

Parse a Document

from pathlib import Path
from reducto import Reducto

client = Reducto()
upload = client.upload(file=Path("sample.pdf"))
result = client.parse.run(document_url=upload)

print(result)
3

Add custom configurations

Reducto’s APIs offer a wide range of configurations that customize for your use case. Check out our API Reference or “Configurations” section for more.
from pathlib import Path
from reducto import Reducto

client = Reducto()
upload = client.upload(file=Path("sample.pdf"))
result = client.parse.run(
  document_url=upload,
  options={ # Sample configurations
    "ocr_mode": "agentic",
    "extraction_mode": "ocr",
    "chunking": {
        "chunk_mode": "variable",
    }
  },
  advanced_options={
    "ocr_system": "multilingual",
    "page_range": {
        "start": 1,
        "end": 10,
    },
    "table_output_format": "ai_json",
    "merge_tables": True,
  },
  experimental_options={
    "enable_checkboxes": True,
    "return_figure_images": False,
    "rotate_pages": True,
  }
)

<Warning>
When enabling `return_figure_images` or `return_table_images`, note that the returned image URLs are transient and auto-delete after ~24 hours. Download and save images to your own storage system immediately.
</Warning>

print(result)

​
Using the REST API Endpoint

All endpoints have an API playground you can explore and use to get sample code. 
import requests

url = "https://platform.reducto.ai/parse"

payload = {
    "options": {
      "ocr_mode": "agentic",
    },
    "advanced_options": {
      "page_range": {
        "start": 1,
        "end": 10,
      },
    },
    "priority": True
}
headers = {
    "Authorization": "Bearer REDUCTO_API_KEY",
    "Content-Type": "application/json"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)