抓取 API：使用固定积分定价获取网页

分类 域名与网站情报

API 端点 4

主要功能 6

常见问题解答 8

被出色公司的人们使用

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

实时服务状态

集成前，请先查看实时服务运行状况和文档中说明的失败响应。

OpenAPI API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

10,000 免费额度

从每月 10,000 积分开始，只有在用量增长时再升级。

这个 API 可以帮你交付什么

把此页面当作生产集成简报：端点、示例、响应结构，以及把 DomScan 接入产品所需的工作流组件。

产品工作流

把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。

分析自动化

用计划任务、告警和可复现的调查步骤替代重复的人工查询。

干净的 JSON 数据

使用可预测字段、已记录的状态码和积分成本，而不是抓取供应商页面。

AI 和运维工具

通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。

集成流程

从第一次请求到可重复生产使用的简单路径。

一次认证

使用文档中的请求头发送 API 密钥，并在服务之间保持请求一致。

用示例查询

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

运行和监控

使用状态码、积分成本和响应字段构建重试、日志和告警。

开发者工具包

从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。

OpenAPI 架构

生成客户端，或检查每种请求和响应结构。

Postman 集合

导入现成请求，用于手动测试和团队交接。

SDK 和 CLI

使用维护中的包和命令行流程，避免编写样板代码。

MCP 集成

把域名情报暴露给 AI 代理和内部助手工作流。

参数和响应映射

在把端点接入客户端前，快速查看输入、输出字段和状态码。

请求参数

参数

urlmodeoutputurlsjob_idlimitoffset

响应字段

响应示例

datadata.urldata.final_urldata.statusdata.outcomedata.content_typedata.contentdata.bytesdata.truncateddata.redirect_countdata.attempt_countdata.duration_ms

状态覆盖

HTTP 状态码

200202400401402403409429503

API 端点

POST /v1/scrape

积分: 1-20/item身份验证: 需要身份验证

urlmodeoutput

POST /v1/scrape/jobs

积分: 1-20/item身份验证: 需要身份验证

modeoutputurls

GET /v1/scrape/jobs/:job_id

积分: 0身份验证: 需要身份验证

job_id

GET /v1/scrape/jobs/:job_id/results

积分: 0身份验证: 需要身份验证

job_idlimitoffset

为每个 URL 选择检索努力

积分基于您请求的模式，而不是目标网站返回的 HTTP 状态或内容。

标准

每个 URL 1 个积分

直接页面的一个标准检索尝试。

弹性

每个 URL 2 个积分

一个标准尝试加上当结果符合记录的重试条件时的一次重试。

渲染

每个 URL 10 个积分

对需要 JavaScript 执行的页面进行一个浏览器渲染的尝试。

渲染弹性

每个 URL 20 个积分

一个浏览器渲染的尝试加上当结果符合记录的重试条件时的一次重试。

弹性模式即使在首次尝试成功时也收取列出的金额。它们包括一个符合条件的重试，而不是无限重试或保证目标网站将返回您期望的内容。

计费反映请求的工作

成功的 API 操作意味着 DomScan 执行了选定的检索模式并返回了生成的目标响应。

结果仍然可能是重定向、HTTP 错误、阻止响应、质询页面、空页面或不符合您需求的内容。这些目标站点成果是可收费的，不符合积分退款的条件。

只有当 DomScan 验证其自身平台未能执行选定的检索模式时，才可进行退款。

浏览器渲染不保证页面会成功加载，弹性模式不保证重试会产生不同的结果。

抓取 API 特定的使用限制

这些限制仅适用于抓取 API。其他账户和平台安全措施也可能适用。

功能	免费账户	付费账户
可用模式	仅标准	全部四种模式
请求率	每分钟 5 个请求	每分钟 60 个请求
并发标准或弹性请求	1 个标准请求	5 个请求
并发渲染请求	不可用	2 个请求
每日配额	100 个请求	基于可用的积分和速率限制
每月配额	500 个请求	基于可用的积分和速率限制
最大返回内容	每个请求 256 KiB	每个请求 512 KiB
异步批次	不可用	可用

当响应超过适用的内容限制时，API 返回许可部分并将响应标记为截断。

异步处理最多 100 个 URL

付费账户可以提交包含最多 100 个 URL 的异步作业。

每分钟最多 5 个新批次作业

每个账户最多 3 个活动作业

每个账户最多 300 个排队的 URL 项

一个作业中最多 100 个 URL

完成的结果可用 24 小时

作业元数据保留 7 天

每个 URL 使用其选定的模式独立计费。

在 24 小时内下载或复制完成的结果。在该期间之后，即使有限的作业元数据仍可用 7 天，响应内容也会被删除。

清晰的范围，没有隐藏的升级选项

无 CAPTCHA 解决方案

浏览器渲染可以执行页面 JavaScript，但抓取 API 不解决 CAPTCHA 或绕过登录要求、付费墙、访问控制或其他限制。目标返回的 CAPTCHA 或质询页面是目标站点成果，不可退款。

无高级代理选择

您选择检索模式和努力级别。没有高级代理、提供商、池或国家选择参数。

可接受的使用

仅对您有法律权限访问和处理的内容使用抓取 API。您负责遵守适用的法律、目标站点条款、隐私义务和必需的权限。

不要使用 API 绕过身份验证、付费墙、CAPTCHA 或访问控制，或用于凭证攻击、账户滥用、骚扰、非法监视或非法收集个人数据。当使用威胁人员、服务或平台时，DomScan 可能会拒绝请求或暂停访问。

集成前可见的信任信号

透明文档、已认证请求和清晰的可靠性信息，让你在上线前更容易评估 DomScan。

服务状态 API 资料

OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。

API 密钥 受保护访问

认证端点使用 API 密钥，并在调用前清楚显示积分成本。

免费额度 免费注册

从每月 10,000 积分开始，只有在用量增长时再升级。

活跃请求示例

从 curl 和 HTTP 示例开始，再把参数映射到你的应用代码。

主要功能

为每个 URL 选择检索努力

积分基于您请求的模式，而不是目标网站返回的 HTTP 状态或内容。

计费反映请求的工作

成功的 API 操作意味着 DomScan 执行了选定的检索模式并返回了生成的目标响应。

异步处理最多 100 个 URL

付费账户可以提交包含最多 100 个 URL 的异步作业。

抓取 API 特定的使用限制

这些限制仅适用于抓取 API。其他账户和平台安全措施也可能适用。

无 CAPTCHA 解决方案

可接受的使用

仅对您有法律权限访问和处理的内容使用抓取 API。您负责遵守适用的法律、目标站点条款、隐私义务和必需的权限。

请求示例

标准请求 bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'

浏览器渲染的请求 bash

curl -X POST "https://domscan.net/v1/scrape" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'

异步批次请求 bash

curl -X POST "https://domscan.net/v1/scrape/jobs" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -H "Idempotency-Key: docs-batch-1" \
  -H "Content-Type: application/json" \
  -d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'

响应示例

成功的标准响应 json

{
  "data": {
    "url": "https://example.com/",
    "final_url": "https://example.com/",
    "status": 200,
    "outcome": "success",
    "content_type": "text/html",
    "content": "<!doctype html>...",
    "bytes": 1256,
    "truncated": false,
    "redirect_count": 0,
    "attempt_count": 1,
    "duration_ms": 428,
    "fetched_at": "2026-08-20T10:30:00.000Z",
    "headers": { "cache-control": "max-age=604800" },
    "rendered": false
  },
  "billing": {
    "credits_charged": 1,
    "credits_refunded": 0,
    "policy": "effort_based"
  }
}

常见问题解答

一个 URL 需要多少积分？

一个 URL 根据选定的模式成本 1、2、10 或 20 个积分。批次项使用相同的按 URL 定价。

如果目标返回错误或阻止页面，我会被收费吗？

是的。目标响应（例如重定向、HTTP 错误、阻止、质询页面、空页面或意外内容）是可收费的，因为 DomScan 仍执行了请求的检索工作。

什么时候请求被退款？

只有当 DomScan 验证其自身平台未能执行选定的检索模式时，才可进行退款。目标站点行为不是平台故障。

弹性模式会继续重试直到页面有效吗？

否。弹性模式在首次结果符合记录的重试条件时包括一次重试。

浏览器渲染解决 CAPTCHA 吗？

否。它执行页面 JavaScript 但不解决 CAPTCHA 或绕过访问限制。

我可以选择高级代理或国家吗？

否。API 不公开代理层级、提供商、池或国家定位。您仅选择检索模式。

免费账户可以提交批次作业吗？

否。异步批次仅对付费账户可用。免费账户可以在发布的免费限制内使用标准模式。

批次结果存储多久？

完成的响应内容可用 24 小时。有限的作业元数据保留 7 天可用。

HTTP 状态码

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

成功 200

请求成功

已接受 202

仅缓存的子域名请求未命中，已接受并在后台刷新。不收取积分；请在 Retry-After 延迟后重试。

请求错误 400

参数无效

未授权 401

API 密钥或会话缺失或无效。

需要付款 402

没有足够额度来执行此请求。

禁止访问 403

已通过身份验证，但无权使用此操作或模式。

HTTP 409 409

我们明确列出了客户端应处理的 HTTP 状态码，帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。

请求过多 429

超出速率限制

服务不可用 503

上游服务不可用或正在临时限流。

获取 API 密钥

免费开始查看文档

客户支持

使用可预测的按 URL 定价获取网页 API

集成前可见的信任信号

这个 API 可以帮你交付什么

集成流程

开发者工具包

参数和响应映射

API 端点

为每个 URL 选择检索努力

标准

弹性

渲染

渲染弹性

计费反映请求的工作

抓取 API 特定的使用限制

异步处理最多 100 个 URL

清晰的范围，没有隐藏的升级选项

无 CAPTCHA 解决方案

无高级代理选择

可接受的使用

集成前可见的信任信号

主要功能

请求示例

响应示例

常见问题解答

相关工具和资源

HTTP 状态码