# well-001-extract-table PDF Table Extractor

> well-001-extract-table PDF Table Extractor is a paid API for AI agents from well-001-extract-table.rainmaker-wells.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-22).

Extracts structured tables from a PDF file (by URL or base64) and returns JSON with headers, rows, and page metadata

## Facts

- Endpoint: POST https://well-001-extract-table.rainmaker-wells.workers.dev/api/extract-table-from-pdf?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/well-001-extract-table-pdf-table-extractor-40a7eaff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ku6x3clMaVynBOJmvgoqe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability well-001-extract-table-pdf-table-extractor-40a7eaff -d '<json body>'
```

Example prompt: Can you extract the tables from this PDF report and give me the data as structured JSON? Here's the URL: https://example.com/quarterly-report.pdf — check up to 5 pages and map the 'Revenue' column to 'revenue_usd'.

## When to prefer this

Choose this endpoint when you need to extract structured tabular data (rows and columns) from a PDF document, especially financial reports, invoices, research papers, or any PDF containing machine-readable tables. It supports both URL-based and base64-encoded PDFs, costs only $0.01 USDC per call, and returns clean JSON with optional header remapping. Best for text-based PDFs; scanned documents require an external hosted parser.

## Known failure modes

- PDF URL is not HTTPS or exceeds 8 MB — request rejected
- Scanned/image-only PDF without hosted parser URL configured — tables cannot be extracted
- max_pages exceeds 10 — capped at 10
- Malformed base64 input — parse error returned
- Payment of $0.01 USDC not completed via x402 — 402 Payment Required response
- PDF has no machine-readable tables — empty tables array with warnings

## How this service works

Extract tables from a PDF ($0.01 USDC via x402). Pass pdf_base64 or a https pdf_url. Optional schema maps headers. Optional max_pages (1-10). Returns JSON { pages, tables: [{ page, headers, rows }], warnings }. Text PDFs are parsed in-worker; scans require HOSTED_PARSER_URL. Provided as is, with no warranty or guarantee of accuracy or fitness. Nothing is stored.

## Output

Returns a JSON object with: 'pages' (number of pages processed), 'tables' (array of objects each containing 'page' number, 'headers' array, and 'rows' array of arrays), and 'warnings' (array of any parsing issues encountered). No data is stored server-side.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "schema": {
   "type": "string",
   "description": "Optional header mapping. Object maps extracted header -> output name; array replaces headers in column order."
  },
  "pdf_url": {
   "type": "string",
   "description": "https URL of a PDF. Provide this or pdf_base64. Max 8 MB."
  },
  "max_pages": {
   "type": "integer",
   "description": "Max pages to read. Capped at 10."
  },
  "pdf_base64": {
   "type": "string",
   "description": "Raw PDF encoded as base64 (optionally a data: URL). Provide this or pdf_url."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/well-001-extract-table-pdf-table-extractor-40a7eaff/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from well-001-extract-table.rainmaker-wells.workers.dev](https://www.zero.xyz/host/well-001-extract-table.rainmaker-wells.workers.dev/llms.txt)