pagetranslate

Translate PDF, scanned PDF, DOCX, EPUB and image documents with PageTranslate, preserving layout

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: Caravaca Labs

Documentation

n8n-nodes-pagetranslate

Translate PDF, scanned PDF, DOCX, EPUB and images with PageTranslate, preserving document layout. OCR handles scanned pages. PDF comes back as PDF, DOCX as DOCX and EPUB as EPUB.

Available on npm with GitHub Actions provenance. Submitted for n8n verification; approval is pending.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

In self-hosted n8n, open Settings > Community Nodes > Install, enter n8n-nodes-pagetranslate, review n8n's community-code warning, and install. n8n Cloud availability requires verification approval and is not yet available.

For a repeatable local verification, build this source checkout and follow the n8n E2E setup with a dedicated test account.

Operations

Document operation Result
Upload Sends a binary file and target language, then returns its word count, quote and status. Does not start translation.
Get Returns one job's status and progress.
Get Many Lists recent jobs, newest first, with an optional limit.
Start Requires Confirm Spending Words; spends existing account word balance, never a card.
Get Download Link Returns a one-hour link for a completed document with filename and expiry in seconds.

Credentials

Create a PageTranslate account, verify your email, and create your own key under Dashboard > API Keys. Add a PageTranslate API credential in n8n and enter the key.

n8n encrypts credentials at rest. The key is sent only to the fixed https://api.pagetranslate.ai origin. The node has no runtime package dependencies, no telemetry, and does not read local files or environment variables.

Compatibility

Uses n8n's community node API v1 and HTTP request helpers, with native multipart FormData. Upload requires binary workflow input; the node is not exposed as an agent tool.

Verified end to end in n8n 2.47.7 on 2026-11-14: real binary upload, quote, rejected unconfirmed start, confirmed start, completed status and byte-verified PDF download. The sanitized report is in verification/e2e-20261114.json.

Usage

  1. Obtain a binary file with an upload form, HTTP Request or storage node.
  2. Choose Document > Upload. Set Input Binary Field and a target language code (es, fr, de, pt-BR, etc.).
  3. Review word_count and cost_cents. If cost_cents is not zero, the existing word balance does not cover the job: do not start it.
  4. Obtain user confirmation, then use Start with job_id and enable Confirm Spending Words. Starting consumes words and cannot be undone.
  5. Use a Wait node (about 30 seconds) and Get to follow progress. Stop on completed, failed or cancelled. Bound the number of polls.
  6. When status is completed, use Get Download Link. An HTTP Request node can fetch download_url as a file. The link expires after one hour.

A start may be refused if another job has spent the balance since upload. The error is reported without creating a checkout or retrying a charge. Never export real keys or signed download URLs in public workflows.

Supported formats: PDF (including scans), DOCX, EPUB, PNG, JPG/JPEG, WEBP, TIFF/TIF, BMP and GIF. Maximum 100 MB and 1,000 PDF pages. Use the original filename extension. Spreadsheets, slides, subtitles and pasted-text translation are not supported. Translation is AI-generated, not certified human translation.

Resources

Online versions

Prefer a browser?

Guides and free tools

Integration documentation

Version history

0.1.1: explicit binary-only node declaration for the n8n package scanner.

0.1.0: initial integration. See CHANGELOG.md.

Development

Run npm ci, npm run build, npm run lint and npm run dev. Publishing is configured for GitHub Actions with npm provenance. Do not publish credentials or test artifacts.

Discussion