Skip to main content
Use the redesigned Extract API to pull specific data fields from a document. You provide a Markdown representation of the document and a schema that defines the fields you want, and the API returns their values in a structured, predictable format along with the location of each value in the source Markdown. The Extract API suits high-volume, repeatable workflows: use it when you need the same set of fields from many documents, such as invoice totals, contract dates, or form field values. Results stay consistent across documents with varying layouts because extraction is schema-driven.

​
How Extract Works

The Extract API works on a Markdown string. That Markdown can come from any source: the Parse API, a third-party parser, a web scraper, or a hand-authored document. For the best results, use Markdown produced by the Parse API, which preserves the document’s reading order and structure and links each extraction back to its parse job. You pass the Markdown and a schema to the endpoint. The API returns the extracted values, per-field range grounding that points back into the source Markdown, and request metadata. To turn those ranges into visual locations (the blocks, page numbers, and bounding boxes each value came from), pass the results to the Ground API.

​
Sample Request

Send the Markdown and a schema to the extract endpoint with a POST request. Replace YOUR_API_KEY with your API key and parse-output.md with the path to your Markdown file.
For the full request and response contract, see the API reference.