Skip to main content
The Parse v2 API converts a document into structured data for retrieval-augmented generation (RAG), search, extraction, or any downstream workflow. It returns a reading-order Markdown rendering of the document, a hierarchical structure of its pages and blocks, and per-block grounding that maps everything back to the source.

​
How Parse Works

You send a PDF or image to the parse endpoint, optionally choosing a model version and customizing the parse with options. The API returns a single JSON response containing the reading-order Markdown, the document structure, per-block grounding, and request metadata. See Parse API Response for the field-by-field reference. If you haven’t made an API call yet, start with the Quickstart to get a real response to follow along with.

​
Call the Parse API

Send a document to the parse endpoint with a POST request. Replace YOUR_API_KEY with your API key and document.pdf with the path to your file. The options field is optional: the defaults suit most documents, so include it only to customize the parse (here, to process specific pages). 
curl -X POST 'https://api.ade.landing.ai/v2/parse' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'document=@document.pdf' \
  -F 'model=dpt-3-pro-latest' \
  -F 'options={"pages":[0]}'
For the full request and response contract, see the API reference.