Capture a web page screenshot
litescrape.web.screenshotCapture a public HTTP(S) page as a PNG
- 价格
- $0.00015/success按供应商原价
- 成功率
- —暂无成功率数据近 30 天 · 0 次
- 延迟 p50
- ——
- 最后验证
- 2026年9月29日实测可用
GEThttps://toolswitch.dev/v1/tools/litescrape.web.screenshot?url=https%3A%2F%2Fexample.com预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
The returned screenshot_url needs the same bearer key for PNG download. That download is free and the URL expires after seven days.
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
url | 字符串 | 必填 | 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 | 字符串 | 可选 | Browser locale as a language tag, 2-64 characters. Defaults to the browser's own. | en-US |
referer | 字符串 | 可选 | HTTP(S) URL sent as the Referer. | https://example.com |
timeout | 数字 | 可选 | 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 | 布尔 | 可选 | Capture the full page when true. The default, false, captures the viewport. | true |
robots_txt | 字符串 | 可选 | User agent, 1-256 characters, to check against the site's robots.txt; disallowed URLs are rejected. | MyBot |
user_agent | 字符串 | 可选 | User-Agent for the page request, 1-1,024 characters without control characters. Defaults to the browser's own. | |
page_timeout | 整数 | 可选 | Seconds from 1 through 180 for page loading and browser operations. Cannot extend the total request budget set by timeout. | 30 |
remove_overlay | 布尔 | 可选 | Remove modal and cookie-banner overlays from the page. | |
respond_timing | 字符串 | 可选 | Page readiness condition to reach before responding. | network-idle |
detach_invisibles | 布尔 | 可选 | Drop display:none elements from the page. | |
wait_for_selector | 字符串 | 可选 | CSS selector to wait for after navigation, 1-2,048 characters. POST also accepts a list of 1-16 selectors. | main |
assert_status_code | 整数 | 可选 | Expected origin HTTP status, 100-599. A different status is rejected; otherwise a rendered error page is a successful capture. | 200 |
- 查询参数
url字符串必填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.comlocale字符串可选Browser locale as a language tag, 2-64 characters. Defaults to the browser's own.
示例:
en-USreferer字符串可选HTTP(S) URL sent as the Referer.
示例:
https://example.comtimeout数字可选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布尔可选Capture the full page when true. The default, false, captures the viewport.
示例:
truerobots_txt字符串可选User agent, 1-256 characters, to check against the site's robots.txt; disallowed URLs are rejected.
示例:
MyBotuser_agent字符串可选User-Agent for the page request, 1-1,024 characters without control characters. Defaults to the browser's own.
page_timeout整数可选Seconds from 1 through 180 for page loading and browser operations. Cannot extend the total request budget set by timeout.
示例:
30remove_overlay布尔可选Remove modal and cookie-banner overlays from the page.
respond_timing字符串可选Page readiness condition to reach before responding.
示例:
network-idledetach_invisibles布尔可选Drop display:none elements from the page.
wait_for_selector字符串可选CSS selector to wait for after navigation, 1-2,048 characters. POST also accepts a list of 1-16 selectors.
示例:
mainassert_status_code整数可选Expected origin HTTP status, 100-599. A different status is rejected; otherwise a rendered error page is a successful capture.
示例:
200
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
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());网关接口为预览版,地址与鉴权方式可能调整。 示例参数仅为样例数据。 调用按 $0.00015/success 计费,已含服务费。