DataForSEO SERP Yahoo Organic Live Advanced

按实际用量计费
ae_dataforseo_serp_yahoo_organic_live_advanced

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

搜索
按实际用量计费

价格说明

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

工具参数

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

参数类型必填说明默认值
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否<em>keyword</em><br><strong>required field</strong><br>you can specify <strong>up to 700 characters</strong> in the <code>keyword</code> field<br><strong>all %## will be decoded (plus character '+' will be decoded to a space character)</strong><br>if you need to use the "%" character for your <code>keyword</code>, please specify it as "%25";<br>if you need to use the “+” character for your <code>keyword</code>, please specify it as “%2B”<p>learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a>—
request_body[].se_domainstring | null否暂无参数说明。—
request_body[].search_paramstring | null否暂无参数说明。—
request_body[].language_codestring否<em>search engine language code</em><br><strong>required field if you don't specify</strong> <code>language_name</code><br><strong>if you use this field, you don't need to specify <code>language_name</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_code</code>_by making a separate request to the <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><em><br></em>example:<em><br></em><code class="long-string">en</code>n—
request_body[].language_namestring否<em>full name of search engine language</em><br><strong>required field if you don't specify</strong> <code>language_code</code><br><strong>if you use this field, you don't need to specify <code>language_code</code></strong><br>you can receive the list of available languages of the search engine with their <code>language_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><br>example:<br><code class="long-string">English</code>—
request_body[].location_codeinteger否<em>search engine location code</em><br><strong>required field if you don't specify</strong> <code>location_name</code>_or <code>location_coordinate</code><br><strong>if you use this field, you don't need to specify <code>location_name</code> or <code>location_coordinate</code></strong><br>you can receive the list of available locations of the search engines with their <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><br>example:<br><code class="long-string">2840</code>n—
request_body[].location_namestring否<em>full name of search engine location</em><br><strong>required field if you don't specify</strong> <code>location_code</code> or <code>location_coordinate</code><br><strong>if you use this field, you don't need to specify <code>location_code</code> or <code>location_coordinate</code></strong><br>you can receive the list of available locations of the search engine with their <code>location_name</code> by making a separate request to the <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations</code><br>example:<br><code class="long-string">London,England,United Kingdom</code>—
request_body[].max_crawl_pagesinteger | null否暂无参数说明。—
request_body[].location_coordinatestring否<em>GPS coordinates of a location</em><br><strong>required field if you don't specify</strong> <code>location_name</code>_or <code>location_code</code><br><strong>if you use this field, you don't need to specify <code>location_name</code> or <code>location_code</code></strong><br><code>location_coordinate</code> parameter should be specified in the <em>"latitude,longitude,radius"</em> format<br>the maximum number of decimal digits for <em>"latitude"</em> and <em>"longitude"</em>: 7<br>the minimum value for <em>"radius"</em>: 199.9 (mm)<br>the maximum value for <em>"radius"</em>: 199999 (mm)<br>example:<br><code class="long-string">53.476225,-2.243572,200</code>n—
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否暂无参数说明。—

调用示例

复制请求代码,查看对应的返回示例。

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_yahoo_organic_live_advanced' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": [
      {
        "depth": 10,
        "device": "desktop",
        "keyword": "AgentEarth",
        "language_code": "en",
        "location_code": 2840,
        "max_crawl_pages": 1,
        "tag": "ae_split_acceptance_20261115_yahoo"
      }
    ]
  }
}'
返回示例response.json
JSON部分内容
{
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "data": {
        "api": "serp",
        "depth": 10,
        "device": "desktop",
        "function": "live",
        "keyword": "AgentEarth",
        "language_code": "en"
      },
      "id": "11150735-2802-0139-0000-341b10024175",
      "path": [
        "v3"
      ],
      "result": [
        {
          "check_url": "https://us.search.yahoo.com/search?p=AgentEarth&vl=lang_en&ei=UTF-8&fl=1&lat=37.09024&lon=-95.712891&locupdate=1&radius=150&fr2=p%3As%2Cv%3Aw%2Cm%3Aloc",
          "datetime": "2026-11-15 07:35:59 +00:00",
          "item_types": [
            "organic"
          ],
          "items": [
            {}
          ],
          "items_count": 7,
          "type": "organic"
        }
      ],
      "result_count": 1,
      "status_code": 20000
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0,
  "time": "2.8351 sec."
}

返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。