DataForSEO SERP Google Organic Live Advanced

按实际用量计费
ae_dataforseo_serp_google_organic_live_advanced

通过 DataForSEO 获取指定关键词和地区的 Google 实时自然搜索结果。请按本接口要求,将任务参数放入 request_body 数组。

搜索
按实际用量计费

价格说明

单次费用为(较大值(1200 × 搜索任务实际计费用量(美元), 0))AE积分。各项条件同时适用,按所选条件计算合计费用。

费用取决于本次调用中的搜索任务数量、实际抓取的搜索结果页数,以及是否启用结果元素像素位置计算、异步 AI 摘要加载、“其他人还问”展开点击或使用特殊搜索操作符。增加请求深度或抓取页数上限可能增加实际抓取量;按实际执行情况结算。异步 AI 摘要未出现或未异步加载,以及“其他人还问”未出现或实际点击少于请求时,相应未发生的附加费用不计入最终费用。

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
request_bodyarray是暂无参数说明。—
request_body[].osstring | null否暂无参数说明。—
request_body[].tagstring | null否暂无参数说明。—
request_body[].urlstring | null否暂无参数说明。—
request_body[].depthinteger | null否暂无参数说明。—
request_body[].devicestring | null否暂无参数说明。—
request_body[].targetstring | null否暂无参数说明。—
request_body[].keywordstring否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_domainstring | null否暂无参数说明。—
request_body[].match_typestring | null否暂无参数说明。—
request_body[].match_valuestring | null否暂无参数说明。—
request_body[].search_paramstring | null否暂无参数说明。—
request_body[].language_codestring | null否暂无参数说明。—
request_body[].language_namestring | null否暂无参数说明。—
request_body[].location_codeinteger | null否暂无参数说明。—
request_body[].location_namestring | null否暂无参数说明。—
request_body[].find_targets_inarray | null否暂无参数说明。—
request_body[].max_crawl_pagesinteger | null否暂无参数说明。—
request_body[].remove_from_urlarray | null否暂无参数说明。—
request_body[].ignore_targets_inarray | null否暂无参数说明。—
request_body[].target_search_modestring | null否暂无参数说明。—
request_body[].location_coordinatestring | null否暂无参数说明。—
request_body[].stop_crawl_on_matcharray | null否暂无参数说明。—
request_body[].stop_crawl_on_match[].match_typestring | null否暂无参数说明。—
request_body[].stop_crawl_on_match[].match_valuestring | null否暂无参数说明。—
request_body[].browser_screen_widthinteger | null否暂无参数说明。—
request_body[].calculate_rectanglesboolean | null否暂无参数说明。—
request_body[].browser_screen_heightinteger | null否暂无参数说明。—
request_body[].group_organic_resultsboolean | null否暂无参数说明。—
request_body[].load_async_ai_overviewboolean | null否暂无参数说明。—
request_body[].people_also_ask_click_depthinteger | null否暂无参数说明。—
request_body[].browser_screen_resolution_ratiointeger | 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
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。