Webpage Translator API

Free Public API

Translate live international web pages into 15+ languages as clean, formatted Markdown.

Try in Live Web Tool

POSThttps://api.headless-lender.com/api/v1/translate

Public: No Key Needed•Highest Free Quota: 1,000 Req/Mo + 10h Browsers (No Card Required)

Overview & Architecture

Fetch foreign-language web pages and translate them into Spanish, French, German, Chinese, Japanese, and more while preserving headlines, links, tables, and document hierarchy.

15+ supported world languages with auto-detection

Markdown formatting and table structures intact

Direct injection into multi-lingual LLM agents

Fast parallel paragraph translation

Playwright Execution & Valkey Caching Pipeline

Because this endpoint utilizes full headless Chromium rendering, dynamic JavaScript and single-page apps (SPAs) are executed completely before conversion:

1. Cold Scrape (Cache MISS)~800ms – 2.5s

Chromium initializes, fetches the URL, executes client JavaScript, resolves DOM mutations, and generates output.

2. Repeat Request (Cache HIT)~5ms – 15ms

Returned instantly from Valkey/Redis cache with header X-Lender-Cache: HIT (15-minute TTL).

Code Integration Examples

Instant Public Endpoint: Zero configuration, no API key needed. Want our highest free quota? Get 1,000 free requests/month + 10 hours of cloud browsers with a free key (No credit card required).

curl -X POST https://api.headless-lender.com/api/v1/translate \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://news.ycombinator.com",
    "targetLang": "es"
  }'

Headers & Authentication Standard

1. Public Access (No Key)

No Authorization header required. Simply send a JSON POST request. Perfect for quick prototypes, small scripts, and low-volume scraping.

Content-Type: application/json

2. Free API Key (Highest Free Quota)

1,000 Req/Mo Free

Sign up in 10s with no credit card required. Unlocks 1,000 free monthly requests, 600 browser minutes (10 hours), 120 req/min burst limits, and cache-bypass controls.

Authorization: Bearer hl_live_your_api_key_here

Access Mode	Monthly Quota	Cloud Browser Time	Burst Limit	Credit Card	Action
Public Anonymous	Daily IP Allowance	5-min trial sandbox	10 req/min	None	Instant (No Setup)
Free Account (Highest Quota)	1,000 Req / Month	600 Mins (10 Hours)	120 req/min	Zero ($0 forever)	Claim Free Key →

Request Body Parameters

Field	Type	Required	Default	Description
url	string	required	—	Webpage URL to translate.
targetLang	string	required	'es'	Target language code (e.g. es, fr, de, zh, ja, ko, ar, pt, it, ru, hi).
sourceLang	string	optional	'auto'	Source language code or 'auto' for automatic detection.
engine	'mdream' \| 'hybrid'	optional	'mdream'	Markdown extraction engine.
includeFrontmatter	boolean	optional	true	Include translation metadata header.

Response Schema & Example

200 OK — application/jsonDuration: ~800ms (Cold) / ~8ms (Cached)

{
  "url": "https://news.ycombinator.com",
  "targetLang": "es",
  "sourceLang": "en",
  "translatedTitle": "Noticias de Hackers",
  "translatedMarkdown": "# Noticias de Hackers\n\n1. Lanzamiento de Next.js 16.4\n2. Infraestructura en la nube de navegadores...",
  "originalWordCount": 650,
  "translatedWordCount": 710,
  "durationMs": 620
}

Scrape to JSON Website Crawler