Parse a document - Unstructured

Parse needs one document source: input for a new upload or file_id for a previous upload. Your API key authenticates the request. All other controls are optional.

Send a document

Set UNSTRUCTURED_API_KEY to your API key and replace document.pdf with your file path. To run the Python or TypeScript example, first install the Python SDK or TypeScript SDK.

export UNSTRUCTURED_API_KEY="your-api-key"

Python
TypeScript
cURL

from unstructured_transform_client import TransformClient

with TransformClient() as client:
    result = client.parse.run(input="document.pdf")
    print(result)

import { readFile } from "node:fs/promises";
import { TransformClient, isAccepted } from "unstructured-transform-client";

const client = new TransformClient();
const file = new File([await readFile("document.pdf")], "document.pdf");
const outcome = await client.parse.run({ input: file });
if (isAccepted(outcome)) {
  console.log("Parse job ID:", outcome.body.id);
} else {
  console.log(outcome.body.markdown);
}

curl https://transform.unstructured.io/api/v2/parse \
  -H "unstructured-api-key: $UNSTRUCTURED_API_KEY" \
  -F "input=@document.pdf"

A synchronous request keeps the connection open until parsing completes. Multi-page documents can take about a minute or longer. That wait is expected. For an immediate response, use asynchronous processing. HTTP 200 returns a document result. Read markdown when processing completes. HTTP 202 means processing continues; retain the response’s Location header and follow request progress.

Choose the output

The default is output=markdown. Add -F "output=elements" to receive individual elements with text, type, and page metadata. In that representation, markdown is null. The optional include query parameter accepts coordinates and table_html only with elements output. Some elements might not include the coordinates or table HTML you request. Check whether each field is present before reading it.

Reuse your document

Use file_id instead of input for a previous upload. After Parse completes, use its id as parse_id to Extract fields. Choose Parse first when you need its Markdown, elements, or a completed Parse to reuse for multiple extractions. To extract fields directly from a document in one request, see Extract directly from a document. See the captured response and optional parameters. See Chain Parse and Extract for a complete sequence that passes the Parse ID into Extract.

​Send a document

​Choose the output

​Reuse your document

Send a document

Choose the output

Reuse your document