# Welcome to PDF.ai API

## PDF.ai API v2 Documentation

Welcome to PDF.ai API v2! Released on 11/28/2025, this version includes advanced endpoints: `parse`, `extract`, `split`, and `ask`. These features are designed to streamline and enhance your workflow. Below, you will find all the necessary documentation to get started with our API.

### Core APIs

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Parse</strong></td><td>Parses a PDF into Markdown or JSON with OCR, VLM support.</td><td><a href="v2/parse">parse</a></td><td><a href="https://1163163551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzXOCOWzP1k1uIbceqZ8s%2Fuploads%2FYfHRR5DAsr0xciVqKXg9%2FYour%20paragraph%20text%20(3).png?alt=media&#x26;token=c25ed844-da63-42cc-b916-31fcee0ef293">Your paragraph text (3).png</a></td></tr><tr><td><strong>Extract</strong></td><td>Exract structured data from PDF documents based on a JSON schema.</td><td><a href="v2/extract">extract</a></td><td><a href="https://1163163551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzXOCOWzP1k1uIbceqZ8s%2Fuploads%2FQzFHVwxxP8dNrVb63lUw%2FYour%20paragraph%20text.png?alt=media&#x26;token=e18ff5f1-9128-4823-aa74-a010467b06a1">Your paragraph text.png</a></td></tr><tr><td><strong>Split</strong></td><td>Divide large PDF files into smaller, more focused documents.</td><td><a href="v2/split">split</a></td><td><a href="https://1163163551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzXOCOWzP1k1uIbceqZ8s%2Fuploads%2FMlAzYmZvTJXlXQdP0Sfb%2FYour%20paragraph%20text%20(2).png?alt=media&#x26;token=012d5410-462c-4a44-b1ba-bd1025fbf5d3">Your paragraph text (2).png</a></td></tr><tr><td><strong>Ask</strong></td><td>Interact with your PDFs by querying information directly.</td><td><a href="v2/ask">ask</a></td><td><a href="https://1163163551-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzXOCOWzP1k1uIbceqZ8s%2Fuploads%2F21T0pvLNUKRnOFPPVBz4%2FYour%20paragraph%20text%20(4).png?alt=media&#x26;token=46ae6eff-3c6b-4e25-9244-5261c67c9114">Your paragraph text (4).png</a></td></tr></tbody></table>

## Try in our playground

Explore our intuitive playground where you can upload your documents, apply schemas, and instantly view the results. It's the perfect way to see our API in action and get hands-on experience. Visit the Playground to start experimenting now!

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Parse playground</strong></td><td><a href="https://pdf.ai/parser">https://pdf.ai/parser</a></td></tr><tr><td><strong>Extract playground</strong></td><td><a href="http://pdf.ai/extract">http://pdf.ai/extract</a></td></tr><tr><td><strong>Split playground</strong></td><td><a href="http://pdf.ai/split">http://pdf.ai/split</a></td></tr></tbody></table>

## Start to integrate

To get started with our API, follow this brief guide to learn how to send your first request quickly and easily.

{% content-ref url="quick-start" %}
[quick-start](https://api.pdf.ai/quick-start)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api.pdf.ai/welcome-to-pdf.ai-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.