https:// 和 www.max_crawl_pages 设为 1 且未指定 start_url 或将其设为首页，以下全站检查将被禁用：test_canonicalization、enable_www_redirect_check、test_hidden_server_signature、test_page_not_found、test_directory_browsing、test_https_redirectforce_sitewide_checks 设为 true。如果 max_crawl_pages 设为 1 且 start_url 指定的不是首页，所有全站检查都将被禁用；force_sitewide_checks 设为 true"
},
"start_url": {
"type": [
"string",
"null"
],
"description": "要爬取的第一个 URLmax_crawl_pages 参数设为 1true；false"
},
"priority_urls": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "绕过队列优先爬取的 URLtarget 域名；allow_subdomains 参数设为 true，否则子域名将被忽略。示例：2000"
},
"store_raw_html": {
"type": [
"boolean",
"null"
],
"description": "存储爬取页面的 HTMLtruefalse"
},
"enable_content_parsing": {
"type": [
"boolean",
"null"
],
"description": "解析爬取页面的内容true 以使用OnPage Content Parsing 端点false"
},
"support_cookies": {
"type": [
"boolean",
"null"
],
"description": "支持爬取页面的 Cookietrue 以在爬取页面时支持 Cookiefalse"
},
"accept_language": {
"type": [
"string",
"null"
],
"description": "访问网站的语言标头\"type\":\"broken"
},
"custom_robots_txt": {
"type": [
"string",
"null"
],
"description": "自定义 robots.txt 设置Disallow: /directory1/"
},
"robots_txt_merge_mode": {
"type": [
"string",
"null"
],
"description": "合并或覆盖 robots.txt 设置merge、override；overridemerge；override，请指定 custom_robots_txt 参数"
},
"custom_user_agent": {
"type": [
"string",
"null"
],
"description": "自定义用户代理Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
Mozilla/5.0 (compatible; RSiteAuditor)"
},
"browser_preset": {
"type": [
"string",
"null"
],
"description": "浏览器屏幕参数预设browser_screen_width、browser_screen_height、browser_screen_scale_factor可选值：desktop、mobile、tabletdesktop 预设将应用以下值：browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1mobile 预设将应用以下值：browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3tablet 预设将应用以下值：browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2enable_javascript 或 enable_browser_rendering 设为 true"
},
"browser_screen_width": {
"type": [
"integer",
"null"
],
"description": "浏览器屏幕宽度browser_preset，它将被忽略；enable_javascript 或 enable_browser_rendering 设为 true最小值（像素）：2409999",
"format": "int64"
},
"browser_screen_height": {
"type": [
"integer",
"null"
],
"description": "浏览器屏幕高度browser_preset，它将被忽略；enable_javascript 或 enable_browser_rendering 设为 true最小值（像素）：2409999"
},
"browser_screen_scale_factor": {
"type": [
"number",
"null"
],
"description": "浏览器屏幕缩放比例browser_preset，它将被忽略；enable_javascript 或 enable_browser_rendering 设为 true最小值：0.53"
},
"respect_sitemap": {
"type": [
"boolean",
"null"
],
"description": "爬取时遵循站点地图true；falsetrue，API 响应中的 click_depth 值将等于 0；max_crawl_depth 字段将被忽略，你可以使用 max_crawl_pages 参数指定要爬取的页面数量"
},
"custom_sitemap": {
"type": [
"string",
"null"
],
"description": "自定义站点地图 URLrespect_sitemap 应为 true"
},
"crawl_sitemap_only": {
"type": [
"boolean",
"null"
],
"description": "仅爬取站点地图中指示的页面truetrue 且未指定 custom_sitemap，将爬取默认站点地图falserespect_sitemap 应为 true"
},
"load_resources": {
"type": [
"boolean",
"null"
],
"description": "加载资源truefalsetrue；false"
},
"enable_javascript": {
"type": [
"boolean",
"null"
],
"description": "在页面中加载 JavaScripttruefalsetruefalse；如果使用此字段，enable_javascript 必须设为 true；"
},
"enable_browser_rendering": {
"type": [
"boolean",
"null"
],
"description": "模拟浏览器渲染以测量 Core Web Vitalsenable_browser_rendering 会加载页面上的样式、图片、字体、动画、视频和其他资源；falsetrue 以在响应中获取 Core Web Vitals（FID、CLS、LCP）指标；enable_javascript 和 load_resources 参数必须设为 truetrue；false"
},
"custom_js": {
"type": [
"string",
"null"
],
"description": "自定义 JavaScriptscr 属性包含 Google Tag Manager：let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute(\"src\");rn if (src != undefined) {rn if (src.indexOf(\"analytics.js\") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf(\"gtm.js\") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;返回值取决于你在此字段中指定的内容。例如，如果指定以下脚本：truefalse"
},
"allow_subdomains": {
"type": [
"boolean",
"null"
],
"description": "包含子域名上的页面truefalse"
},
"allowed_subdomains": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "要抓取的子域名[\"blog.site.com\", \"my.site.com\", \"shop.site.com\"]allow_subdomains 参数应设为 false；allowed_subdomains 字段的内容将被忽略，结果将针对所有子域名返回"
},
"disallowed_subdomains": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "不爬取的子域名[\"status.site.com\", \"docs.site.com\"]allow_subdomains 参数应设为 true"
},
"check_spell": {
"type": [
"boolean",
"null"
],
"description": "检查拼写true 可使用 Hunspell 库检查网站上的拼写false"
},
"check_spell_language": {
"type": [
"string",
"null"
],
"description": "拼写检查的语言\"SERP\", \"minifiers\", \"JavaScript\""
},
"calculate_keyword_density": {
"type": [
"boolean",
"null"
],
"description": "计算目标域名的关键词密度truefalsechecks 对象中的参数指定自定义阈值；high_loading_time 和 large_page_size 参数默认分别设为 3 秒和 1 兆字节；checks，以阻止它们在 target 网站上运行：\"test_page_not_found\"\"test_canonicalization\"\"test_https_redirect\"\"test_directory_browsing\"示例：\"disable_sitewide_checks\": [\"test_directory_browsing\", \"test_page_not_found\"]在帮助中心了解更多"
},
"disable_page_checks": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "阻止某些页面检查运行checks，以阻止其运行并影响 onpage_score。示例：\"disable_page_checks\": [\"is_5xx_code\", \"is_4xx_code\"]"
},
"switch_pool": {
"type": [
"boolean",
"null"
],
"description": "切换代理池true，将使用其他代理池获取所请求的数据；rate-limit 和/或 site_unreachable 错误，可以使用此参数"
},
"return_despite_timeout": {
"type": [
"boolean",
"null"
],
"description": "即使超时也返回页面数据true，将提供在 120 秒内加载失败并返回超时错误的页面的数据；false"
},
"tag": {
"type": [
"string",
"null"
],
"description": "用户自定义任务标识符data 对象中找到指定的 tag 值"
},
"pingback_url": {
"type": [
"string",
"null"
],
"description": "任务完成通知 URL$id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tagpingback_url 中的特殊字符会进行 URL 编码；# 字符会被编码为 %23详情请参阅我们的 帮助中心"
}
},
"example": [
{
"target": "dataforseo.com",
"max_crawl_pages": 10,
"load_resources": true,
"enable_javascript": true,
"custom_js": "meta = {}; meta.url = document.URL; meta;",
"tag": "some_string_123",
"pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
}
]
}
]
},
"example": [
{
"target": "dataforseo.com",
"max_crawl_pages": 10,
"load_resources": true,
"enable_javascript": true,
"custom_js": "meta = {}; meta.url = document.URL; meta;",
"tag": "some_string_123",
"pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
}
]
}
```
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — 联系 Felo 支持时需提供的请求标识符。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_OnPageTaskPostResponseInfo"
}
]
}
```
### 400 — 无法处理该请求。请检查请求参数。
### 401 — 需要有效的 Felo API 密钥。
### 402 — 由于未满足计费要求，请求无法继续。
### 403 — 该账户无权执行此操作。
### 429 — 已达到请求或支出限额。
### 502 — 服务无法完成该请求。
### 503 — API 或计费服务暂时不可用。
### 504 — 服务在处理请求时超时。
### default — 错误响应；上游透传响应可能采用提供方格式
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API 的当前版本"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "通用状态码\n完整响应码列表见此处"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "通用信息性消息\n完整的一般信息性消息列表见此处"
},
"time": {
"type": [
"string",
"null"
],
"description": "总执行时间，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任务总费用，美元",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "tasks 数组中的任务数",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "tasks 数组中返回错误的任务数",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "任务标识符\n我们系统中 UUID 格式的唯一任务标识符"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "任务的状态码\n由 DataForSEO 生成，范围如下：10000-60000\n完整响应码列表见此处"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "任务的信息性消息\n完整的一般信息性消息列表见此处"
},
"time": {
"type": [
"string",
"null"
],
"description": "执行时间，秒"
},
"cost": {
"type": [
"number",
"null"
],
"description": "任务总费用，美元",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "result 数组中的元素数",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "URL 路径"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "包含你在 POST 请求中指定的相同参数"
}
}
}
```
### Response36Afe1097B20_OnPageTaskPostResponseInfo
`#/components/schemas/Response36Afe1097B20_OnPageTaskPostResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_OnPageTaskPostTaskInfo"
}
]
},
"description": "任务数组"
}
}
}
]
}
```
### Response36Afe1097B20_OnPageTaskPostTaskInfo
`#/components/schemas/Response36Afe1097B20_OnPageTaskPostTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"object",
"null"
],
"description": "结果数组
在本例中，该值将为 null"
}
}
}
]
}
```