ADE Parse - LandingAI

cURL

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'

import requests

url = 'https://api.ade.landing.ai/v2/parse'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}

files = {'document': open('document.pdf', 'rb')}
data = {'model': 'dpt-3-pro-latest'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const form = new FormData();
form.append('document', fs.createReadStream('document.pdf'));
form.append('model', 'dpt-3-pro-latest');

axios.post('https://api.ade.landing.ai/v2/parse', form, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY', ...form.getHeaders() }
})
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

{
  "markdown": "<string>",
  "metadata": {
    "job_id": "<string>",
    "model_version": "<string>",
    "page_count": 123,
    "output_markdown_chars": 123,
    "range_units": "<string>",
    "openapi_spec": "<string>",
    "failed_pages": [
      123
    ],
    "duration_ms": 123,
    "billing": {
      "total_credits": 123
    }
  },
  "structure": {
    "type": "document",
    "children": [
      {
        "grounding": {
          "page": 123,
          "range": {
            "start": 123,
            "end": 123
          },
          "box": {
            "xmin": 123,
            "ymin": 123,
            "xmax": 123,
            "ymax": 123
          }
        },
        "type": "page",
        "status": "ok",
        "reason": "<string>",
        "children": [
          {
            "id": "<string>",
            "grounding": {
              "page": 123,
              "range": {
                "start": 123,
                "end": 123
              },
              "box": {
                "xmin": 123,
                "ymin": 123,
                "xmax": 123,
                "ymax": 123
              }
            },
            "atomic_grounding": [
              {
                "page": 123,
                "range": {
                  "start": 123,
                  "end": 123
                },
                "box": {
                  "xmin": 123,
                  "ymin": 123,
                  "xmax": 123,
                  "ymax": 123
                }
              }
            ],
            "children": [
              "<unknown>"
            ],
            "markdown": "<string>",
            "row": 123,
            "col": 123,
            "colspan": 123,
            "rowspan": 123
          }
        ],
        "markdown": "<string>"
      }
    ],
    "markdown": "<string>"
  }
}

{
  "markdown": "<string>",
  "metadata": {
    "job_id": "<string>",
    "model_version": "<string>",
    "page_count": 123,
    "output_markdown_chars": 123,
    "range_units": "<string>",
    "openapi_spec": "<string>",
    "failed_pages": [
      123
    ],
    "duration_ms": 123,
    "billing": {
      "total_credits": 123
    }
  },
  "structure": {
    "type": "document",
    "children": [
      {
        "grounding": {
          "page": 123,
          "range": {
            "start": 123,
            "end": 123
          },
          "box": {
            "xmin": 123,
            "ymin": 123,
            "xmax": 123,
            "ymax": 123
          }
        },
        "type": "page",
        "status": "ok",
        "reason": "<string>",
        "children": [
          {
            "id": "<string>",
            "grounding": {
              "page": 123,
              "range": {
                "start": 123,
                "end": 123
              },
              "box": {
                "xmin": 123,
                "ymin": 123,
                "xmax": 123,
                "ymax": 123
              }
            },
            "atomic_grounding": [
              {
                "page": 123,
                "range": {
                  "start": 123,
                  "end": 123
                },
                "box": {
                  "xmin": 123,
                  "ymin": 123,
                  "xmax": 123,
                  "ymax": 123
                }
              }
            ],
            "children": [
              "<unknown>"
            ],
            "markdown": "<string>",
            "row": 123,
            "col": 123,
            "colspan": 123,
            "rowspan": 123
          }
        ],
        "markdown": "<string>"
      }
    ],
    "markdown": "<string>"
  }
}

{
  "code": "<string>",
  "message": "<string>"
}

POST

parse

cURL

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'

import requests

url = 'https://api.ade.landing.ai/v2/parse'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}

files = {'document': open('document.pdf', 'rb')}
data = {'model': 'dpt-3-pro-latest'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const form = new FormData();
form.append('document', fs.createReadStream('document.pdf'));
form.append('model', 'dpt-3-pro-latest');

axios.post('https://api.ade.landing.ai/v2/parse', form, {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY', ...form.getHeaders() }
})
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

{
  "markdown": "<string>",
  "metadata": {
    "job_id": "<string>",
    "model_version": "<string>",
    "page_count": 123,
    "output_markdown_chars": 123,
    "range_units": "<string>",
    "openapi_spec": "<string>",
    "failed_pages": [
      123
    ],
    "duration_ms": 123,
    "billing": {
      "total_credits": 123
    }
  },
  "structure": {
    "type": "document",
    "children": [
      {
        "grounding": {
          "page": 123,
          "range": {
            "start": 123,
            "end": 123
          },
          "box": {
            "xmin": 123,
            "ymin": 123,
            "xmax": 123,
            "ymax": 123
          }
        },
        "type": "page",
        "status": "ok",
        "reason": "<string>",
        "children": [
          {
            "id": "<string>",
            "grounding": {
              "page": 123,
              "range": {
                "start": 123,
                "end": 123
              },
              "box": {
                "xmin": 123,
                "ymin": 123,
                "xmax": 123,
                "ymax": 123
              }
            },
            "atomic_grounding": [
              {
                "page": 123,
                "range": {
                  "start": 123,
                  "end": 123
                },
                "box": {
                  "xmin": 123,
                  "ymin": 123,
                  "xmax": 123,
                  "ymax": 123
                }
              }
            ],
            "children": [
              "<unknown>"
            ],
            "markdown": "<string>",
            "row": 123,
            "col": 123,
            "colspan": 123,
            "rowspan": 123
          }
        ],
        "markdown": "<string>"
      }
    ],
    "markdown": "<string>"
  }
}

{
  "markdown": "<string>",
  "metadata": {
    "job_id": "<string>",
    "model_version": "<string>",
    "page_count": 123,
    "output_markdown_chars": 123,
    "range_units": "<string>",
    "openapi_spec": "<string>",
    "failed_pages": [
      123
    ],
    "duration_ms": 123,
    "billing": {
      "total_credits": 123
    }
  },
  "structure": {
    "type": "document",
    "children": [
      {
        "grounding": {
          "page": 123,
          "range": {
            "start": 123,
            "end": 123
          },
          "box": {
            "xmin": 123,
            "ymin": 123,
            "xmax": 123,
            "ymax": 123
          }
        },
        "type": "page",
        "status": "ok",
        "reason": "<string>",
        "children": [
          {
            "id": "<string>",
            "grounding": {
              "page": 123,
              "range": {
                "start": 123,
                "end": 123
              },
              "box": {
                "xmin": 123,
                "ymin": 123,
                "xmax": 123,
                "ymax": 123
              }
            },
            "atomic_grounding": [
              {
                "page": 123,
                "range": {
                  "start": 123,
                  "end": 123
                },
                "box": {
                  "xmin": 123,
                  "ymin": 123,
                  "xmax": 123,
                  "ymax": 123
                }
              }
            ],
            "children": [
              "<unknown>"
            ],
            "markdown": "<string>",
            "row": 123,
            "col": 123,
            "colspan": 123,
            "rowspan": 123
          }
        ],
        "markdown": "<string>"
      }
    ],
    "markdown": "<string>"
  }
}

{
  "code": "<string>",
  "message": "<string>"
}

Body

multipart/form-data

document

file

The file to parse. The file must be a PDF or image; see the list of supported file types. Provide either document or document_url, not both.

document_url

string

A publicly accessible URL to the file to parse. The file must be a PDF or image; see the list of supported file types. Provide either document or document_url, not both.

model

string

The DPT-3 model snapshot to use for this request. Accepts a dated snapshot (for example, dpt-3-pro-20260710), the dpt-3-pro-latest alias, or the bare dpt-3-pro family name (equivalent to dpt-3-pro-latest). Defaults to the latest DPT-3 Pro snapshot.

options

ParseOptions · object

Optional object that customizes the parse. Use it to select which pages to process, adjust how content appears in the Markdown, or control how much detail the response includes. Sent as a JSON-serialized string in form data.

Show child attributes

Response

The parse response

The parse result: the full document as markdown, its hierarchical structure (with per-node spatial grounding inline), and request metadata.

markdown

string

required

The full document as a single Markdown string, in reading order.

metadata

ParseMetadata · object

required

Information about the request: model version, page count, duration, billing, and more.

Show child attributes

structure

Document · object

required

The document's hierarchical structure: pages and the elements detected on each page. Every node below the root carries its spatial data inline in a grounding object ({page, range, box}, normalized page coordinates); leaf elements additionally carry atomic_grounding.

Show child attributes

ADE List Parse Jobs

⌘I