DataForSEO SERP Yahoo Organic Live Advanced
按实际用量计费
ae_dataforseo_serp_yahoo_organic_live_advanced
通过 DataForSEO 获取指定关键词和地区的 Yahoo 实时自然搜索结果。请按本接口要求,将任务参数放入 request_body 数组。
按实际用量计费
价格说明
单次费用为(较大值(1200 × 实际查询费用(美元), 0))AE积分。各项条件同时适用,按所选条件计算合计费用。
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
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 | 否 | <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_domain | string | null | 否 | 暂无参数说明。 | — |
request_body[].search_param | string | null | 否 | 暂无参数说明。 | — |
request_body[].language_code | string | 否 | <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_name | string | 否 | <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_code | integer | 否 | <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_name | string | 否 | <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_pages | integer | null | 否 | 暂无参数说明。 | — |
request_body[].location_coordinate | string | 否 | <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_match | array | null | 否 | 暂无参数说明。 | — |
request_body[].stop_crawl_on_match[].match_type | string | null | 否 | 暂无参数说明。 | — |
request_body[].stop_crawl_on_match[].match_value | string | 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
{
"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。



