Capture a web page screenshot
litescrape.web.screenshotCapture a public HTTP(S) page as a PNG
- Price
- $0.00015/successAl precio del proveedor
- Success rate
- —Aún no hay datos de tasa de éxitoLast 30 days · 0 calls
- Latency p50
- ——
- Last verified
- 29 sept 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.web.screenshot?url=https%3A%2F%2Fexample.comPreview- Uses platform quota
- Synchronous response
- Reads public data
Parámetros
The returned screenshot_url needs the same bearer key for PNG download. That download is free and the URL expires after seven days.
| Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
url | cadena | Obligatorio | Public HTTP(S) URL to capture, 1-8,192 characters. Include http:// or https://; bare domains are rejected. The host must be public, on port 80 or 443, without embedded credentials. | https://example.com |
locale | cadena | Opcional | Browser locale as a language tag, 2-64 characters. Defaults to the browser's own. | en-US |
referer | cadena | Opcional | HTTP(S) URL sent as the Referer. | https://example.com |
timeout | número | Opcional | Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline. | |
full_page | booleano | Opcional | Capture the full page when true. The default, false, captures the viewport. | true |
robots_txt | cadena | Opcional | User agent, 1-256 characters, to check against the site's robots.txt; disallowed URLs are rejected. | MyBot |
user_agent | cadena | Opcional | User-Agent for the page request, 1-1,024 characters without control characters. Defaults to the browser's own. | |
page_timeout | entero | Opcional | Seconds from 1 through 180 for page loading and browser operations. Cannot extend the total request budget set by timeout. | 30 |
remove_overlay | booleano | Opcional | Remove modal and cookie-banner overlays from the page. | |
respond_timing | cadena | Opcional | Page readiness condition to reach before responding. | network-idle |
detach_invisibles | booleano | Opcional | Drop display:none elements from the page. | |
wait_for_selector | cadena | Opcional | CSS selector to wait for after navigation, 1-2,048 characters. POST also accepts a list of 1-16 selectors. | main |
assert_status_code | entero | Opcional | Expected origin HTTP status, 100-599. A different status is rejected; otherwise a rendered error page is a successful capture. | 200 |
- Parámetros de consulta
urlcadenaObligatorioPublic HTTP(S) URL to capture, 1-8,192 characters. Include http:// or https://; bare domains are rejected. The host must be public, on port 80 or 443, without embedded credentials.
Ejemplo:
https://example.comlocalecadenaOpcionalBrowser locale as a language tag, 2-64 characters. Defaults to the browser's own.
Ejemplo:
en-USreferercadenaOpcionalHTTP(S) URL sent as the Referer.
Ejemplo:
https://example.comtimeoutnúmeroOpcionalOptional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
full_pagebooleanoOpcionalCapture the full page when true. The default, false, captures the viewport.
Ejemplo:
truerobots_txtcadenaOpcionalUser agent, 1-256 characters, to check against the site's robots.txt; disallowed URLs are rejected.
Ejemplo:
MyBotuser_agentcadenaOpcionalUser-Agent for the page request, 1-1,024 characters without control characters. Defaults to the browser's own.
page_timeoutenteroOpcionalSeconds from 1 through 180 for page loading and browser operations. Cannot extend the total request budget set by timeout.
Ejemplo:
30remove_overlaybooleanoOpcionalRemove modal and cookie-banner overlays from the page.
respond_timingcadenaOpcionalPage readiness condition to reach before responding.
Ejemplo:
network-idledetach_invisiblesbooleanoOpcionalDrop display:none elements from the page.
wait_for_selectorcadenaOpcionalCSS selector to wait for after navigation, 1-2,048 characters. POST also accepts a list of 1-16 selectors.
Ejemplo:
mainassert_status_codeenteroOpcionalExpected origin HTTP status, 100-599. A different status is rejected; otherwise a rendered error page is a successful capture.
Ejemplo:
200
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.web.screenshot?url=https%3A%2F%2Fexample.com' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.web.screenshot?url=https%3A%2F%2Fexample.com",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.web.screenshot?url=https%3A%2F%2Fexample.com", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.00015/success, incluida la tarifa de servicio.