Skip to main content
Use the redesigned Extract v2 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 v2 API, a third-party parser, a web scraper, or a hand-authored document. For the best results, use Markdown produced by the Parse v2 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 span grounding that points back into the source Markdown, and request metadata.

​
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. 
curl -X POST 'https://api.ade.landing.ai/v2/extract' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'markdown=@parse-output.md' \
  -F 'schema={"type":"object","properties":{"revenue":{"type":"string","description":"Q1 2024 revenue"}}}'
For the full request and response contract, see the API reference.