DataForSEO SERP Google Organic Live Advanced
按实际用量计费
ae_dataforseo_serp_google_organic_live_advanced
通过 DataForSEO 获取指定关键词和地区的 Google 实时自然搜索结果。请按本接口要求,将任务参数放入 request_body 数组。
按实际用量计费
价格说明
单次费用为(较大值(1200 × 搜索任务实际计费用量(美元), 0))AE积分。各项条件同时适用,按所选条件计算合计费用。
费用取决于本次调用中的搜索任务数量、实际抓取的搜索结果页数,以及是否启用结果元素像素位置计算、异步 AI 摘要加载、“其他人还问”展开点击或使用特殊搜索操作符。增加请求深度或抓取页数上限可能增加实际抓取量;按实际执行情况结算。异步 AI 摘要未出现或未异步加载,以及“其他人还问”未出现或实际点击少于请求时,相应未发生的附加费用不计入最终费用。
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
request_body | array | 是 | 暂无参数说明。 | — |
request_body[].os | string | null | 否 | 暂无参数说明。 | — |
request_body[].tag | string | null | 否 | 暂无参数说明。 | — |
request_body[].url | string | null | 否 | 暂无参数说明。 | — |
request_body[].depth | integer | null | 否 | 暂无参数说明。 | — |
request_body[].device | string | null | 否 | 暂无参数说明。 | — |
request_body[].target | string | null | 否 | 暂无参数说明。 | — |
request_body[].keyword | string | 否 | keywordrequired fieldyou can specify up to 700 characters in the keyword fieldall %## will be decoded (plus character ‘+’ will be decoded to a space character)if you need to use the “%” character for your keyword, please specify it as “%25”;if you need to use the “+” character for your keyword, please specify it as “%2B”;if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, the charge per task will be multiplied by 5learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article | — |
request_body[].se_domain | string | null | 否 | 暂无参数说明。 | — |
request_body[].match_type | string | null | 否 | 暂无参数说明。 | — |
request_body[].match_value | string | null | 否 | 暂无参数说明。 | — |
request_body[].search_param | string | null | 否 | 暂无参数说明。 | — |
request_body[].language_code | string | null | 否 | 暂无参数说明。 | — |
request_body[].language_name | string | null | 否 | 暂无参数说明。 | — |
request_body[].location_code | integer | null | 否 | 暂无参数说明。 | — |
request_body[].location_name | string | null | 否 | 暂无参数说明。 | — |
request_body[].find_targets_in | array | null | 否 | 暂无参数说明。 | — |
request_body[].max_crawl_pages | integer | null | 否 | 暂无参数说明。 | — |
request_body[].remove_from_url | array | null | 否 | 暂无参数说明。 | — |
request_body[].ignore_targets_in | array | null | 否 | 暂无参数说明。 | — |
request_body[].target_search_mode | string | null | 否 | 暂无参数说明。 | — |
request_body[].location_coordinate | string | null | 否 | 暂无参数说明。 | — |
request_body[].stop_crawl_on_match | array | null | 否 | 暂无参数说明。 | — |
request_body[].stop_crawl_on_match[].match_type | string | null | 否 | 暂无参数说明。 | — |
request_body[].stop_crawl_on_match[].match_value | string | null | 否 | 暂无参数说明。 | — |
request_body[].browser_screen_width | integer | null | 否 | 暂无参数说明。 | — |
request_body[].calculate_rectangles | boolean | null | 否 | 暂无参数说明。 | — |
request_body[].browser_screen_height | integer | null | 否 | 暂无参数说明。 | — |
request_body[].group_organic_results | boolean | null | 否 | 暂无参数说明。 | — |
request_body[].load_async_ai_overview | boolean | null | 否 | 暂无参数说明。 | — |
request_body[].people_also_ask_click_depth | integer | null | 否 | 暂无参数说明。 | — |
request_body[].browser_screen_resolution_ratio | integer | null | 否 | 暂无参数说明。 | — |
调用示例
复制请求代码,查看对应的返回示例。
POST
/agent-api/v1/tool/executeX-Api-Key请求代码request.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_serp_google_organic_live_advanced' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": [
{
"depth": 10,
"keyword": "custom mailer boxes",
"language_code": "en",
"location_code": 2840
}
]
}
}'返回示例response.json
{
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"data": {
"api": "serp",
"depth": 10,
"device": "desktop",
"function": "live",
"keyword": "custom mailer boxes",
"language_code": "en"
},
"id": "11180647-2802-0139-0000-f7d07f96f00f",
"path": [
"v3"
],
"result": [
{
"check_url": "https://www.google.com/search?q=custom%20mailer%20boxes&hl=en&gl=US&ie=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
"datetime": "2026-11-18 06:47:39 +00:00",
"item_types": [
"organic"
],
"items_count": 17,
"keyword": "custom mailer boxes",
"type": "organic"
}
],
"result_count": 1,
"status_code": 20000
}
],
"tasks_count": 1,
"tasks_error": 0,
"time": "6.8143 sec."
}返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。



