捕获页面或元素 PNG 截图

curl -sS -X POST "https://api.adscrawl.net/screenshot" \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://example.com",
    "viewport": { "width": 1440, "height": 900 },
    "fullPage": true,
    "waitUntil": "load",
    "countryCode": "GLOBAL",
    "userAgentMode": "random",
    "userAgentOs": "windows"
  }' \
  --output page.png

curl -sS -X POST "https://api.adscrawl.net/screenshot" \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://example.com",
    "selector": "#hero",
    "waitUntil": "load",
    "countryCode": "US"
  }' \
  --output hero.png

import fs from "fs";

const response = await fetch("https://api.adscrawl.net/screenshot", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    url: "https://example.com",
    viewport: { width: 1440, height: 900 },
    fullPage: true,
    waitUntil: "load",
    countryCode: "GLOBAL",
    userAgentMode: "random",
    userAgentOs: "windows",
  }),
});

if (!response.ok) {
  const err = await response.json();
  throw new Error(`${response.status} ${err.code}: ${err.error}`);
}

const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("page.png", buffer);

import httpx

response = httpx.post(
    "https://api.adscrawl.net/screenshot",
    headers={
        "content-type": "application/json",
        "x-api-key": "YOUR_API_KEY",
    },
    json={
        "url": "https://example.com",
        "viewport": {"width": 1440, "height": 900},
        "fullPage": True,
        "waitUntil": "load",
        "countryCode": "GLOBAL",
        "userAgentMode": "random",
        "userAgentOs": "windows",
    },
)

response.raise_for_status()
with open("page.png", "wb") as f:
    f.write(response.content)

HTTP/1.1 200 OK
Content-Type: image/png

<binary PNG stream>

{
  "error": "Content selector was not found",
  "code": "CONTENT_SELECTOR_NOT_FOUND"
}

{
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS",
  "balance": 0,
  "requiredCredits": 1
}

{
  "error": "countryCode is not supported",
  "code": "INVALID_COUNTRY_CODE"
}

{
  "error": "Dynamic country/region routing is unavailable",
  "code": "DYNAMIC_PROXY_NOT_CONFIGURED"
}

POST

screenshot

curl -sS -X POST "https://api.adscrawl.net/screenshot" \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://example.com",
    "viewport": { "width": 1440, "height": 900 },
    "fullPage": true,
    "waitUntil": "load",
    "countryCode": "GLOBAL",
    "userAgentMode": "random",
    "userAgentOs": "windows"
  }' \
  --output page.png

curl -sS -X POST "https://api.adscrawl.net/screenshot" \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://example.com",
    "selector": "#hero",
    "waitUntil": "load",
    "countryCode": "US"
  }' \
  --output hero.png

import fs from "fs";

const response = await fetch("https://api.adscrawl.net/screenshot", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    url: "https://example.com",
    viewport: { width: 1440, height: 900 },
    fullPage: true,
    waitUntil: "load",
    countryCode: "GLOBAL",
    userAgentMode: "random",
    userAgentOs: "windows",
  }),
});

if (!response.ok) {
  const err = await response.json();
  throw new Error(`${response.status} ${err.code}: ${err.error}`);
}

const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("page.png", buffer);

import httpx

response = httpx.post(
    "https://api.adscrawl.net/screenshot",
    headers={
        "content-type": "application/json",
        "x-api-key": "YOUR_API_KEY",
    },
    json={
        "url": "https://example.com",
        "viewport": {"width": 1440, "height": 900},
        "fullPage": True,
        "waitUntil": "load",
        "countryCode": "GLOBAL",
        "userAgentMode": "random",
        "userAgentOs": "windows",
    },
)

response.raise_for_status()
with open("page.png", "wb") as f:
    f.write(response.content)

HTTP/1.1 200 OK
Content-Type: image/png

<binary PNG stream>

{
  "error": "Content selector was not found",
  "code": "CONTENT_SELECTOR_NOT_FOUND"
}

{
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS",
  "balance": 0,
  "requiredCredits": 1
}

{
  "error": "countryCode is not supported",
  "code": "INVALID_COUNTRY_CODE"
}

{
  "error": "Dynamic country/region routing is unavailable",
  "code": "DYNAMIC_PROXY_NOT_CONFIGURED"
}

使用 POST /screenshot 捕获任意公开网页的像素级 PNG 截图。可请求整页截图，或使用 CSS 选择器定位特定元素。所有内容均在真实浏览器中渲染，配合随机指纹和住宅代理路由，确保你看到的内容与真实访客完全一致。

string

必填

目标页面 URL。必须是可通过 HTTP(S) 访问的 URL，使用 80 或 443 端口。

object

渲染和捕获时使用的视口尺寸。

显示 viewport 字段

number

视口宽度，单位为像素。

number

视口高度，单位为像素。

boolean

是否捕获完整可滚动页面。默认值为 true。当提供了 selector 时，无论此值如何，仅捕获匹配的元素。

string

要捕获的元素的 CSS 选择器。仅对第一个匹配的元素进行截图。如果页面上未找到该选择器，则返回 422 CONTENT_SELECTOR_NOT_FOUND。

string

在捕获前等待的导航事件。默认值为 "load"。

Value	Behaviour
`"domcontentloaded"`	等待 DOMContentLoaded。HTML 已解析，无需等待图片等次要资源。
`"load"`	等待页面和依赖资源（图片、样式表）加载完成后的 `window.load`。
`"networkidle"`	等待至少 500 毫秒内没有任何网络连接。长轮询、分析脚本或懒加载资源可能导致超时。

number

任务完成的最长等待时间，单位为毫秒。必须是正整数且不超过 3,600,000。超出范围的值将回退为服务器默认值。

string

浏览器语言环境，例如 "en-US" 或 "zh-CN"。会影响 navigator.language 和 Accept-Language header。

string

IANA 时区标识符，例如 "Asia/Shanghai" 或 "America/New_York"。

object

通过 Geolocation API 暴露给页面的地理位置坐标。

显示 geolocation 字段

number

纬度，以十进制度数表示。

number

经度，以十进制度数表示。

object

自定义代理配置。不能与 countryCode 同时使用。提供 server 或拆分形式（protocol + host + port）。不能将凭据嵌入 server 中。

显示 proxy 字段

string

完整的代理 URL，如 http://host:port 或 socks5://host:port。不能与 host 同时使用。

string

"http" 或 "socks5"。用于拆分形式。

string

代理主机。用于拆分形式。

number | string

端口，范围为 1 到 65535。

string

代理用户名。必须与 password 一起提供。

string

代理密码。必须与 username 一起提供。

string

管理的住宅代理区域。不能与 proxy 同时使用。

"GLOBAL"：从 15 个热门区域中动态选择出口。
两位字母国家代码（例如 "US"、"DE"）：优先使用该区域的受信任代理，并支持动态回退。
省略：自动随机选择受信任代理。

string

"random" 让服务器从其库中选择 User-Agent。未显式提供 userAgent 的请求已默认使用 "random"。

string

当 userAgentMode 为 "random" 时使用的操作系统。可选值："windows"（默认）或 "macos"。

string

显式指定 User-Agent 字符串。覆盖随机选择。

object

浏览器指纹设置。省略时，所有信号默认随机，同时保持操作系统、GPU、CPU、内存、字体和设备信号的一致性。

显示 fingerprint 字段

string

"forward" 使用代理出口地址。也可使用 "real" 或 "disabled"。

string

"random" 或 "real"。控制 WebGL 厂商和渲染器元数据。

string

"random"、"real" 或 "disabled"。随机模式遵循 WebGL GPU 设置。

string

"random" 或 "real"。控制 WebGL 图像噪声。

string

"random" 或 "real"。控制 canvas 噪声。

string

"random" 或 "real"。控制音频指纹噪声。

string

"random" 或 "real"。控制布局测量噪声。

string

"random" 或 "real"。返回与操作系统匹配的语音列表。

string

"random" 或 "real"。返回与操作系统匹配的字体列表。

string

"random" 或 "real"。生成一致的 CPU 线程数和内存配对。

string

"random"、"enabled" 或 "disabled"。

array

在导航前注入浏览器上下文的 Cookie 列表。每个 Cookie 对象需要 name、value 和 domain。

显示 cookie 字段

string

必填

Cookie 名称。

string

必填

Cookie 值。

string

必填

目标域名，如 .example.com。

string

Cookie 路径。默认值为 /。

boolean

是否仅通过 HTTPS 发送 Cookie。

boolean

是否禁止客户端 JavaScript 访问 Cookie。

string

SameSite 属性。

boolean

设置为 true 表示会话 Cookie。

number

Unix 过期时间戳，单位为秒。也接受 expires 或 expiry。

响应

Code	Meaning
`200`	成功。返回 `image/png` 二进制流，包含捕获的页面或元素。
`400`	JSON、URL、Cookie、代理、区域或 User-Agent 参数无效。请求体超过 1 MiB。
`401`	`x-api-key` 缺失或无效。
`402`	余额不足。返回 `INSUFFICIENT_CREDITS`、`balance` 和 `requiredCredits`。
`422`	未找到选择器（`CONTENT_SELECTOR_NOT_FOUND`）或 Worker payload 无效。
`429`	任务请求频率受限。
`502`	代理不可达或目标 HTTP 失败。
`503`	队列、Worker、管理代理或 User-Agent 资源不可用。
`504`	任务、导航或代理连接超时。
`500`	未分类的任务执行失败。

当使用 selector 时，服务器会等待元素出现后再进行捕获。如果元素在导航超时内未找到，则返回 422 CONTENT_SELECTOR_NOT_FOUND。

一次请求验证后会消耗 1 积分，在任务入队之前扣除。请求体限制为 1 MiB。

curl -sS -X POST "https://api.adscrawl.net/screenshot" \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://example.com",
    "viewport": { "width": 1440, "height": 900 },
    "fullPage": true,
    "waitUntil": "load",
    "countryCode": "GLOBAL",
    "userAgentMode": "random",
    "userAgentOs": "windows"
  }' \
  --output page.png

curl -sS -X POST "https://api.adscrawl.net/screenshot" \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://example.com",
    "selector": "#hero",
    "waitUntil": "load",
    "countryCode": "US"
  }' \
  --output hero.png

import fs from "fs";

const response = await fetch("https://api.adscrawl.net/screenshot", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    url: "https://example.com",
    viewport: { width: 1440, height: 900 },
    fullPage: true,
    waitUntil: "load",
    countryCode: "GLOBAL",
    userAgentMode: "random",
    userAgentOs: "windows",
  }),
});

if (!response.ok) {
  const err = await response.json();
  throw new Error(`${response.status} ${err.code}: ${err.error}`);
}

const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("page.png", buffer);

import httpx

response = httpx.post(
    "https://api.adscrawl.net/screenshot",
    headers={
        "content-type": "application/json",
        "x-api-key": "YOUR_API_KEY",
    },
    json={
        "url": "https://example.com",
        "viewport": {"width": 1440, "height": 900},
        "fullPage": True,
        "waitUntil": "load",
        "countryCode": "GLOBAL",
        "userAgentMode": "random",
        "userAgentOs": "windows",
    },
)

response.raise_for_status()
with open("page.png", "wb") as f:
    f.write(response.content)

HTTP/1.1 200 OK
Content-Type: image/png

<binary PNG stream>

{
  "error": "Content selector was not found",
  "code": "CONTENT_SELECTOR_NOT_FOUND"
}

{
  "error": "Insufficient credits",
  "code": "INSUFFICIENT_CREDITS",
  "balance": 0,
  "requiredCredits": 1
}

{
  "error": "countryCode is not supported",
  "code": "INVALID_COUNTRY_CODE"
}

{
  "error": "Dynamic country/region routing is unavailable",
  "code": "DYNAMIC_PROXY_NOT_CONFIGURED"
}

概览

浏览器任务

远程 CDP

云浏览器

捕获页面或元素 PNG 截图

响应

​响应

响应