# Tanod Docs PDF Table Extractor

> Tanod Docs PDF Table Extractor is a paid API for AI agents from docs.tanod.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-13).

Extracts tables from a PDF file and returns them as structured JSON, CSV, or Excel (XLSX) with per-table page, bounding box, headers, and row data.

## Facts

- Endpoint: POST https://docs.tanod.dev/v1/pdf/tables?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-docs-pdf-table-extractor-eff14e70
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hc8mHGCGS8NTklkLk3hcC

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 tanod-docs-pdf-table-extractor-eff14e70 -d '<json body>'
```

Example prompt: Pull all the tables from this PDF report — https://example.com/annual-report.pdf — and give me the data in JSON format so I can see each table's headers and rows.

## When to prefer this

Choose this endpoint when you need to extract structured tabular data from a PDF — especially for reports, financial documents, or data exports where you need headers and rows. It is purpose-built for PDF table detection and returns rich metadata (page, bounding box, header detection) in multiple output formats (JSON, CSV, XLSX). Prefer it over generic PDF-to-text or OCR endpoints when the output must be machine-readable structured tables rather than raw text.

## Known failure modes

- PDF URL is inaccessible, private, or internal (IP-literal hosts refused)
- File exceeds 20 MB via URL or 10 MB via base64
- No tables detected in the specified pages
- Page range is invalid or exceeds 200-page limit
- PDF is scanned/image-only with no extractable text (pages_without_text returned)
- Invalid base64 encoding for file_base64 input
- Unsupported format or output enum value

## How this service works

Documents: DOCX template fill, Office to PDF, any file to Markdown, PDF to Word, OCR, PDF pipeline.

## Output

A JSON response containing the operation type, input byte size, page count, and a `tables` array. Each table entry includes its page number, bounding box coordinates, auto-generated name, detection method, column count, row count, a `header` array of column names, and a `rows` array of string arrays. For CSV or XLSX output formats, the file is returned either base64-encoded inline or as a time-limited download URL with expiry, byte size, content type, and SHA-256 hash.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2048,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Public http(s) URL of the PDF (at most 20 MB; private, internal and IP-literal hosts are refused); or use file_base64."
  },
  "pages": {
   "anyOf": [
    {
     "type": "string",
     "pattern": "^[0-9a-zA-Z ,\\-]+$",
     "maxLength": 200,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Pages to read (default all; at most 200 per call): N, N-M, N- (to the end), -M, last; comma separated, e.g. 1-5,9."
  },
  "format": {
   "enum": [
    "json",
    "csv",
    "xlsx"
   ],
   "type": "string",
   "default": "json",
   "description": "json (default: every table with its page, box, header and rows), csv (one CSV file per table) or xlsx (one workbook, a sheet per table)."
  },
  "output": {
   "enum": [
    "base64",
    "url"
   ],
   "type": "string",
   "default": "base64",
   "description": "base64 (default): the file comes back inline as base64. url: the file is stored for 24 hours and the reply carries a download link (url, expires_at, bytes, content_type, sha256) instead of the base64, which keeps the file out of your context window."
  },
  "file_base64": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 13398872,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "The PDF as base64 (at most 10 MB decoded); or use url."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "format": "json",
  "tables": [
   {
    "bbox": [
     56,
     130,
     536,
     262
    ],
    "name": "page1-table1",
    "page": 1,
    "rows": [
     [
      "North",
      "1,204",
      "1,311",
      "1,402",
      "1,590",
      "5,507"
     ],
     [
      "South",
      "980",
      "1,015",
      "1,120",
      "1,205",
      "4,320"
     ],
     [
      "East",
      "1,512",
      "1,498",
      "1,630",
      "1,774",
      "6,414"
     ],
     [
      "West",
      "866",
      "902",
      "951",
      "1,040",
      "3,759"
     ],
     [
      "Total",
      "4,562",
      "4,726",
      "5,103",
      "5,609",
      "20,000"
     ]
    ],
    "index": 1,
    "header": [
     "Region",
     "Q1",
     "Q2",
     "Q3",
     "Q4",
     "Total"
    ],
    "method": "lines",
    "columns": 6,
    "row_count": 5
   }
  ],
  "operation": "tables",
  "input_bytes": 2963,
  "input_pages": 1,
  "table_count": 1,
  "pages_processed": 1,
  "untrusted_content": true,
  "pages_without_text": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-docs-pdf-table-extractor-eff14e70/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from docs.tanod.dev](https://www.zero.xyz/host/docs.tanod.dev/llms.txt)