HeadlessLender Cloud API Documentation

API Reference & Integration Guide

HeadlessLender provides low-latency cloud Chromium lending infrastructure over native Chrome DevTools Protocol (CDP) WebSocket and high-speed REST extraction APIs for AI agents, Python, and Node.js.

HIGHEST FREE QUOTA AVAILABLE100% Free Forever • Zero Card Required

Claim 1,000 Free Requests/Month + 10 Hours of Cloud Browsers

All 13 secondary tools can be queried immediately via public endpoints with no API key needed (100 req/day). For production volume, 120 req/min burst speed, and custom cache control, simply sign up for a free developer account in 10 seconds.

Claim 1,000 Free Requests
Access Modes & Authentication

1. Public API (No Key Needed)

Instant Access

All 13 extraction tools are completely open to call without creating an account or providing an API key. Perfect for quick scripts, evaluation, and prototyping.

curl -X POST https://api.headless-lender.com/api/v1/markdown \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

2. Free API Key (Highest Free Quota)

1,000 Req/Mo • No Card

Unlock our highest free tier: 1,000 free monthly requests + 10 hours (600 mins) of cloud Chromium browsers, 120 req/min burst limits, and cache-bypass controls.

Authorization: Bearer hl_live_your_api_key_here
Free Access Tier Comparison
TierMonthly QuotaCloud Browser TimeBurst Rate LimitCredit CardSetup
Public Anonymous100 req/day5-min trial sandbox10 req/minNot RequiredInstant (0s)
Free Developer Key (Highest Quota)1,000 Req / Month600 Mins (10 Hours)120 req/minZero ($0 forever)10s Sign-up →

Dedicated API Endpoints

Choose any feature below to inspect its dedicated API specification, parameter tables, and copyable code samples.

Content & LLM

POST /api/v1/markdown1 Credit per request

URL to Markdown

Strip clutter, extract clean structured Markdown, and save up to 88% tokens for RAG pipelines.

POST /api/v1/article1 Credit per extraction

Article Extractor

Extract clean article text, author, publish date, reading time, and distraction-free content.

POST /api/v1/translate1 Credit per translation

Webpage Translator

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

POST /api/v1/text1 Credit per text extraction

Plain Text Extractor

Extract clean, human-readable plain text with boilerplate and script tag removal.

Data & Scraping

POST /api/v1/json1 Credit per scrape

Scrape to JSON

Scrape any dynamic webpage into structured JSON schema using intuitive CSS selectors.

POST /api/v1/tables1 Credit per table extraction

Table Extractor

Extract tabular data from complex web pages into clean CSV, JSON, and interactive data grids.

POST /api/v1/metadata1 Credit per inspection

Metadata Checker

Inspect Google SERP snippets, Twitter Cards, OpenGraph tags, and JSON-LD schema.

POST /api/v1/links1 Credit per link extraction

Link Extractor

Discover all internal and external hyperlinks, anchor texts, and domain frequency breakdowns.

Browser Automation

POST /api/v1/screenshot1 Credit per screenshot

Website Screenshot

Capture crisp, pixel-perfect PNG & JPEG screenshots of any dynamic website at scale.

POST /api/v1/pdf1 Credit per PDF generation

Webpage to PDF

Generate publication-grade PDF documents from HTML, URLs, and web apps with CSS paged media.

POST /api/v1/crawl1 Credit per crawled page

Website Crawler

Recursively crawl entire websites, discover URLs, and build site hierarchies with smart boundaries.

POST /api/v1/render1 Credit per render

JS HTML Renderer

Execute client-side JavaScript, hydrate SPAs (React, Vue, Angular), and extract the fully rendered DOM.

Cloud Infrastructure

POST /api/v1/sessions10 Credits per active browser session hour

Live Browser Sandbox

Lease isolated cloud Chromium browsers on demand via native Chrome DevTools Protocol (CDP) WebSocket.

HTTP Status Codes & Errors

StatusCodeDescription
200OKThe request succeeded and execution result is returned.
400Bad RequestMissing URL parameter or invalid JSON request body.
401UnauthorizedInvalid or missing API key in the Authorization header.
429Quota ExceededMonthly credit quota exhausted or concurrency limit hit.
502Bad GatewayUpstream Playwright cluster unreachable or target website blocked loopback.