PDF Evidence Reader

What does PDF Evidence Reader do?

Find page-cited passages matching your literal terms in one public HTTPS PDF. Supply one to five terms and receive a compact JSON report with passage text, physical page numbers and explicit coverage. The Actor does not generate an answer, run OCR, interpret regular expressions or extract the whole document.

The Actor examines embedded text in PDFs up to 10 MiB and 100 physical pages. Each report includes a SHA-256 digest, redacted retrieval provenance, examined-page coverage, and explicit truncation or document-state signals. Returned passages can be partial; they are not a complete evidence review.

When should an agent select this tool?

Use it when the agent already has a public PDF URL and literal terms, and needs short inspectable passages with physical page citations. Use a different tool for OCR, semantic search, full-document extraction or generated answers. A local PDF parser remains an alternative for agents with code execution.

Use from an AI agent through MCP

Add this URL to a client that supports remote HTTP MCP, then authorize with your own Apify account using the Apify MCP setup guide:

https://mcp.apify.com/?tools=l3digital/pdf-evidence-reader

This configuration selects the Actor directly. Availability still depends on Apify account and Actor eligibility. Call l3digital/pdf-evidence-reader with the example input below; the pricing and input restrictions on this page apply.

When using call-actor, its response contains run status and storage IDs. If the run is still active, check that run with get-actor-run. After success, retrieve the report with get-dataset-items using the returned dataset ID (defaultDatasetId in the run API). These retrieval tools load with the Actor. Retrieve the existing result instead of starting another run. Inspect the report status and the coverage or refusal fields described below before using its values.

Why use PDF Evidence Reader?

• Retrieve several terms in one Actor/API call.
• Keep passage text within a caller-selected aggregate character budget.
• Cite one-based physical PDF page numbers.
• Distinguish no matches, likely scanned/image-only PDFs, encryption, truncation, and safe acquisition/parser errors.
• Prevent access to private networks through URL, DNS-answer, redirect, and connected-peer checks.

It is designed for agents that need inspectable evidence rather than a generated conclusion. A caller must still judge source authority, meaning, and reuse rights.

What data can PDF Evidence Reader extract?

Field	Type	Description
status	string	ok, partial, no_matches, scan_needed, encrypted, or error
passages	array	Page number, bounded text, and terms found in that passage
matchedTerms	array	Requested terms represented in returned passages
coverage	object	Pages examined and every relevant truncation signal
provenance	object	Redacted URLs, exact byte count, SHA-256, and hop counts

How to retrieve page-cited PDF evidence

1. Supply a direct public https:// PDF URL. URLs with credentials or explicit ports are rejected.
2. Add one to five literal terms. Matching ignores case; terms are never treated as regex.
3. Optionally reduce maxPassages from 10 or maxOutputCharacters from 12,000.
4. Run the Actor and read the single item in the default dataset.
5. Check status, coverage, and truncated before using any passage.

{
  "url": "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
  "searchTerms": ["Dummy", "PDF"]
}

Demo: locate terms in a longer public document

{
  "url": "https://www.irs.gov/pub/irs-pdf/fw9.pdf",
  "searchTerms": [
    "certification",
    "exempt payee"
  ],
  "maxPassages": 5,
  "maxOutputCharacters": 2000
}

An internal validation run on 2026-09-06 examined six pages and returned four passages totaling 1,923 characters. The report was partial with characterLimitReached: true; the first passage cited physical page 1. This is a passage-location example, not tax advice. The source file can change.

An agent should cite the returned page and provenance, disclose truncation, and narrow its terms or increase its budget when more evidence is needed. A no-match result is limited to the reported extraction coverage; it does not prove a claim is absent from every part of the document. A useful partial report carries the same $0.05 charge.

Input

See the input tab for the full schema. PDFs must be publicly reachable over standard-port HTTPS, at most 10 MiB, at most 100 pages for complete page coverage, unencrypted, and contain embedded text. Redirect destinations receive the same checks. Query strings may be used for acquisition but are removed from report provenance.

Output

You can download the dataset in formats such as JSON, HTML, CSV, or Excel. The Actor writes exactly one versioned report for an accepted input, including expected failure states.

Observed output excerpt from the W3C test PDF in an internal run on 2026-09-06 (the full dataset contains all schema fields):

{
  "schemaVersion": "pdf-evidence-reader/v1",
  "status": "ok",
  "passages": [
    {
      "pageNumber": 1,
      "text": "Dummy PDF file",
      "matchedTerms": [
        "Dummy",
        "PDF"
      ]
    }
  ],
  "totalPassageCharacters": 14,
  "truncated": false,
  "coverage": {
    "pagesDeclared": 1,
    "pagesExamined": 1,
    "pagesWithText": 1,
    "pageLimitReached": false,
    "extractionTextTruncated": false,
    "passageLimitReached": false,
    "characterLimitReached": false,
    "complete": true
  }
}

scan_needed means no embedded text was found in the examined pages; the Actor does not perform OCR. complete describes page/extraction coverage, not factual completeness or source authority. partial means useful passages were returned but a limit reduced extraction coverage or the returned evidence. Passage and character limits can truncate output even when coverage.complete is true.

How much does PDF evidence retrieval cost?

The price is $0.05 per useful report, charged once after the report is stored. Both ok and partial reports containing passages qualify for the custom event, including results truncated by caller-selected limits. No-match results, invalid inputs, and technical or document errors are free of the custom report charge. There are no separate start or dataset-item charges. The Store pricing tab is authoritative.

Privacy, security, and support

The Actor sends a fixed unauthenticated GET request only to the caller-provided public PDF host and validated redirects. It does not forward cookies, authorization headers, Actor credentials, or environment proxy settings. Retrieved document text appears only in bounded result passages; source bytes are temporary and deleted after parsing.

Use only documents you may lawfully retrieve and process. Public availability does not establish authority, ownership, accuracy, or reuse rights. Results can contain personal data present in public documents; ensure you have a legitimate purpose and follow applicable privacy law. Use the Actor Issues tab for defects and the API tab for programmatic calls.