Web Render API — Smallapis

3 endpoints

Click one to see its parameters and a ready-to-paste curl call.

POST /v1/render/screenshot Screenshot a URL or raw HTML

Cookie banners and ad networks are hidden by default, so captures look like a clean first visit.

Returns: binary image

Parameter	Type	Description
`url`	`string`	Page to capture. Either this or `html` is required.
`html`	`string`	Raw HTML to render instead of a URL.
`fullPage`	`boolean`	Capture the whole scrollable page. Default: `false`
`width`	`integer`	Viewport width. Default: `1280`
`height`	`integer`	Viewport height. Default: `800`
`scale`	`number`	Device pixel ratio, 1-3. Default: `1`
`format`	`string`	png, jpeg or webp. Default: `png`
`selector`	`string`	Capture only the element matching this CSS selector.
`mobile`	`boolean`	Emulate a mobile device. Default: `false`
`darkMode`	`boolean`	Request the dark colour scheme. Default: `false`
`hideCookieBanners`	`boolean`	Hide consent and paywall overlays. Default: `true`
`blockAds`	`boolean`	Block known ad and tracker hosts. Default: `true`
`delay`	`integer`	Extra wait in milliseconds after load, max 15000. Default: `0`
`waitForSelector`	`string`	Wait until this CSS selector appears.
`base64`	`boolean`	Return JSON with a base64 payload instead of a binary body. Default: `false`

curl -X POST "https://173-249-18-142.sslip.io/v1/render/screenshot" \
  -H "X-API-Key: $SMALLAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","fullPage":false,"width":1280,"height":800,"scale":1}' \
  --output result.bin

POST /v1/render/pdf Turn a URL or HTML into a PDF

Turn a URL or HTML into a PDF

Returns: binary pdf

Parameter	Type	Description
`url`	`string`	Page to print. Either this or `html` is required.
`html`	`string`	Raw HTML to print instead of a URL.
`paperFormat`	`string`	A0-A5, Letter, Legal, Ledger or Tabloid. Default: `A4`
`landscape`	`boolean`	Landscape orientation. Default: `false`
`margin`	`string`	CSS length applied to all four margins. Default: `10mm`
`printBackground`	`boolean`	Keep background colours and images. Default: `true`
`mediaType`	`string`	print or screen. Default: `print`

curl -X POST "https://173-249-18-142.sslip.io/v1/render/pdf" \
  -H "X-API-Key: $SMALLAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","paperFormat":"A4","landscape":false,"margin":"10mm","printBackground":true}' \
  --output result.bin

POST /v1/render/content Extract title, meta, headings and readable text from a page

Runs the page in a real browser first, so single-page apps return their rendered content rather than an empty shell.

Returns: json

Parameter	Type	Description
`url` required	`string`	Page to read.
`text`	`boolean`	Include the readable text body. Default: `true`
`links`	`boolean`	Include up to 500 outgoing links. Default: `false`

curl -X POST "https://173-249-18-142.sslip.io/v1/render/content" \
  -H "X-API-Key: $SMALLAPIS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","text":true,"links":false}'