关键词
必填字段
在 keyword 字段中最多可指定 700 个字符
所有 %## 都将被解码（另外，字符 ‘+’ 会被解码为空格字符）
如果需要在 keyword 中使用 “%” 字符，请将其指定为 “%25”；
如果需要在 keyword 中使用 “+” 字符，请将其指定为 “%2B”；
如果此字段包含 ‘allinanchor:’、‘allintext:’、‘allintitle:’、‘allinurl:’、‘cache:’、‘define:’、‘filetype:’、‘id:’、‘inanchor:’、‘info:’、‘intext:’、‘intitle:’、‘inurl:’、‘link:’、‘site:’，每个任务的费用将乘以 5
有关 DataForSEO API 中 keyword 和 keywords 字段的规则与限制，请参阅这篇帮助中心文章
搜索引擎地点代码
未指定 location_name 或 location_coordinate 时为必填字段
如果使用此字段，则无需指定 location_name 或 location_coordinate
可单独向 https://api.dataforseo.com/v3/serp/google/locations 发起请求，获取搜索引擎的可用地点及其 location_code 列表
示例：
2840
搜索引擎语言代码
未指定 language_name 时为必填字段
如果使用此字段，则无需指定 language_name
可单独向 https://api.dataforseo.com/v3/serp/google/languages 发起请求，获取搜索引擎的可用语言及其 language_code 列表示例：en
解析深度
可选字段
SERP 中的结果数量
默认值：10
最大值：700
将深度设为 10 以上可能会产生额外费用（如果搜索引擎返回超过 10 条结果）；
费用可在 价格页计算。" }, "device": { "type": [ "string", "null" ], "description": "
设备类型
可选字段
返回特定设备类型的结果
可取值为：desktop、mobile
默认值：desktop
加载异步 AI 概览
可选字段
设为 true 以获取 SERP 中的 ai_overview 项，即使它们是异步加载的；
如果设为 false，你将只能从缓存中获取 ai_overview 项；
默认值：false
注意：使用此参数将额外收取 $0.0006；
如果该元素不存在或包含 \"asynchronous_ai_overview\": false，所有额外费用将退还到你的账户余额
任务完成通知 URL
可选字段
任务完成后，我们会向你指定的 URL 发送 GET 请求进行通知
可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值。
示例：
http://your-server.com/pingscript?id=$id
http://your-server.com/pingscript?id=$id&tag=$tag
注意：pingback_url 中的特殊字符会进行 URL 编码；
例如，# 字符会被编码为 %23
详情请参阅我们的帮助中心
" }, "postback_url": { "type": [ "string", "null" ], "description": "用于发送任务结果的 URL
可选字段
任务完成后，我们会将结果以 gzip 格式压缩，并向你指定的 postback_url 发送 POST 请求
可将 ‘$id’ 字符串用作 $id 变量，将 ‘$tag’ 用作经 URL 编码的 $tag 变量。发送请求前我们会设置必要的值
示例：
http://your-server.com/postbackscript?id=$id
http://your-server.com/postbackscript?id=$id&tag=$tag
注意：postback_url 中的特殊字符会进行 URL 编码；
例如，# 字符会被编码为 %23
详情请参阅我们的 帮助中心
" }, "postback_data": { "type": "string", "description": "postback_url 数据类型
指定 postback_url 时为必填字段
对应于将发送到你服务器的数据类型
可取值为：
regular、advanced、html
任务优先级
可选字段
可取以下值：
1 – 正常执行优先级（默认设置）；
2 – 高执行优先级
费用可在 价格页计算。" }, "location_name": { "type": "string", "description": "
搜索引擎地点全名
未指定 location_code 或 location_coordinate 时为必填字段
如果使用此字段，则无需指定 location_code 或 location_coordinate
可单独向 https://api.dataforseo.com/v3/serp/google/locations 发起请求，获取搜索引擎的可用地点及其 location_name 列表
示例：
London,England,United Kingdom
地点的 GPS 坐标
未指定 location_name 或 location_code 时为必填字段
如果使用此字段，则无需指定 location_name 或 location_code
location_coordinate 参数应采用 \"latitude,longitude,radius\" 格式
\"latitude\" 和 \"longitude\" 的最大小数位数：7
\"radius\" 的最小值：199（mm）
\"radius\" 的最大值：199999（mm）
示例：
53.476225,-2.243572,200
搜索引擎语言全名
未指定 language_code 时为必填字段
如果使用此字段，则无需指定 language_code
可单独向 https://api.dataforseo.com/v3/serp/google/languages 发起请求，获取搜索引擎的可用语言及其 language_name 列表
示例：
English
用户自定义任务标识符
可选字段
字符数上限为 255
可使用此参数标识任务，并将其与结果对应
指定的 tag 值可在响应的 data 对象中找到
设备操作系统
可选字段
如果在 device 字段中指定 desktop，请从以下值中选择：windows、macos
默认值：windows
如果在 device 字段中指定 mobile，请从以下值中选择：android、ios
默认值：android
目标匹配类型
指定 stop_crawl_on_match 时为必填字段
match_value 的匹配类型
可取的值：
domain – 特定域名或子域名
with_subdomains – 主域名和子域名
wildcard – 通配符模式
目标域名、子域名或通配符值
指定 stop_crawl_on_match 时为必填字段
指定目标域名、子域名或通配符值；
注意：域名或子域名指定时不得包含请求协议；
示例：\"match_value\": \"dataforseo.com\"，
\"match_value\": \"/blog/post-*\"
页面抓取上限
可选字段
要抓取的搜索结果页数
最大值：100
注意：每抓取一个页面都会收费（每页 10 条自然结果）；
详情请参阅我们的价格页；
注意#2：max_crawl_pages 和 depth 参数相互补充；
详情请参阅我们的帮助中心
" }, "search_param": { "type": [ "string", "null" ], "description": "搜索查询的附加参数
可选字段
lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。"
},
"remove_from_url": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "从 URL 中移除特定参数
可选字段
使用此字段，最多可指定 10 个要从结果 URL 中移除的参数
示例：
\"remove_from_url\": [\"srsltid\"]
展开 AI 概览
可选字段
设为 true 以展开 ai_overview 项；
默认值：false；
注意：此参数仅适用于 HTML 任务结果
" }, "people_also_ask_click_depth": { "type": [ "integer", "null" ], "description": "相应元素上的点击次数
可选字段
指定 people_also_ask 元素上的点击深度，以获取额外的 people_also_ask_element 项；
注意 你的账户将按每次点击额外计费 $0.00015，无论任务优先级如何；
如果该元素不存在或我们执行的点击次数少于你指定的次数，所有额外费用将退还到你的账户余额
可取的值：1 到 4
显示相关结果
可选字段
如果设为 true，响应中的 related_result 元素将作为其父级自然结果的摘要提供；
如果设为 false，related_result 元素将作为单独的自然结果提供；
默认值：true
计算高级结果中 SERP 元素的像素排名
可选字段
像素排名是指结果摘要与屏幕左上角之间的距离；
默认情况下，该参数设为 false
注意：使用此参数将额外收取 $0.0006
" }, "browser_screen_width": { "type": [ "integer", "null" ], "description": "浏览器屏幕宽度
可选字段
你可以为特定设备设置自定义浏览器屏幕宽度，以计算像素排名；
可指定范围：240-9999；
默认情况下，该参数设为：
1920（desktop）；
360（mobile，android）；
375（mobile，iOS）；
注意：要使用此参数，请将 calculate_rectangles 设为 true
浏览器屏幕高度
可选字段
你可以为特定设备设置自定义浏览器屏幕高度，以计算像素排名；
可指定范围：240-9999；
默认情况下，该参数设为：
1080（desktop）；
640（mobile，android）；
812（mobile，iOS）；
注意：要使用此参数，请将 calculate_rectangles 设为 true
浏览器屏幕分辨率比例
可选字段
你可以为特定设备设置自定义浏览器屏幕分辨率比例，以计算像素排名；
可指定范围：0.5-3；
默认情况下，该参数设为：
1（desktop）；
3（mobile，android）；
3（mobile，iOS）；
注意：要使用此参数，请将 calculate_rectangles 设为 true
搜索查询的直接 URL
可选字段
你可以指定一个直接 URL，我们会将其解析到必要字段。注意，此方法对我们的 API 来说处理难度最大，并且要求你在 URL 中指定确切的语言和地点。大多数情况下，我们不建议使用此方法。
示例：
https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。"
},
"target_search_mode": {
"type": [
"string",
"null"
],
"description": "目标匹配模式
可选字段
要启用此参数，还必须启用 stop_crawl_on_match
定义在 stop_crawl_on_match 中指定多个目标时爬取应如何停止
可能的值：all、any
all – 仅当找到所有指定目标时爬取才停止
any – 找到任意单个目标时爬取即停止
默认值：any
详情请参阅我们 帮助中心中的此参数说明
" }, "find_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "要检查目标的 SERP 元素类型
可选字段
要启用此参数，还必须启用 stop_crawl_on_match
指定应检查哪些 SERP 元素类型以匹配目标
如果未指定，将检查所有带有 url 和 domain 字段的一级元素是否匹配目标
可取的值：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter
注意：不能包含与 ignore_targets_in 相同的元素类型
示例：
\"find_targets_in\": [\"organic\", \"featured_snippet\"]
详情请参阅我们帮助中心中的此参数说明
" }, "ignore_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "要从目标搜索中排除的 SERP 元素类型
可选字段
要启用此参数，还必须启用 stop_crawl_on_match
指定在搜索目标匹配时应排除哪些 SERP 元素类型
可取的值：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter
注意：不能包含与 find_targets_in 相同的元素类型
示例：
\"ignore_targets_in\": [\"paid\", \"images\"]
详情请参阅我们帮助中心中的此参数说明
" }, "se_domain": { "type": [ "string", "null" ], "description": "搜索引擎域名
可选字段
我们会根据你指定的地点和语言自动选择相关的搜索引擎域名
不过，你也可以在此字段中设置自定义搜索引擎域名
示例：
google.co.uk, google.com.au, google.de 等。
null"
}
}
}
]
}
```