# Agent Souk PDF Text Extractor

> Agent Souk PDF Text Extractor is a paid API for AI agents from api.agentsouk.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Fetches a PDF from a public URL and extracts its text content page-by-page, along with document metadata

## Facts

- Endpoint: POST https://api.agentsouk.dev/v1/x402/lst_01M2N6GWB06867BFMSKJATK2QC?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-souk-pdf-text-extractor-7a2ed72f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TLRKk3hUM2UFePYTUOuzR

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 agent-souk-pdf-text-extractor-7a2ed72f -d '<json body>'
```

Example prompt: Can you fetch the PDF at https://example.com/report.pdf and extract the text from pages 1-10?

## When to prefer this

Choose this endpoint when you need to programmatically read the text content of a remotely hosted PDF, especially when you need per-page granularity and document metadata. It is preferable over general web scraping endpoints when the source is definitely a PDF file. Use it as a preprocessing step before LLM-based summarization, classification, or structured extraction.

## Known failure modes

- URL is not publicly accessible or returns a non-200 HTTP status
- URL does not point to a valid PDF file
- PDF is encrypted or password-protected and cannot be parsed
- Requested page range exceeds the document's actual page count
- max_chars limit reached before all requested pages are extracted
- PDF contains only scanned images with no embedded text (returns empty text per page)
- Network timeout fetching a large PDF

## How this service works

Fetch a PDF and extract its text per page, with the document info

## Output

Returns the extracted text content organized per page along with document metadata such as page count, title, author, and other PDF info fields. Text is limited by the max_chars parameter (default 50,000, up to 200,000 characters).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "Public http(s) URL of a PDF"
  },
  "pages": {
   "type": "string",
   "pattern": "^\\d{1,6}(-\\d{1,6})?(,\\d{1,6}(-\\d{1,6})?)*$",
   "description": "Pages to extract, e.g. \"1-5\" or \"1,3,8-10\" (at most 100); the first 100 by default"
  },
  "max_chars": {
   "type": "integer",
   "default": 50000,
   "maximum": 200000,
   "minimum": 100
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-souk-pdf-text-extractor-7a2ed72f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentsouk.dev](https://www.zero.xyz/host/api.agentsouk.dev/llms.txt)