DataForSEO SERP Yahoo Organic Live Advanced

Usage-based pricing
ae_dataforseo_serp_yahoo_organic_live_advanced

Get live Yahoo organic search results through DataForSEO for a keyword and geographic location. Put task parameters in the request_body array according to this interface schema.

Search
Usage-based pricing

Pricing

The charge per call is (max(1200 × actual search charge (USD), 0)) AE credits. All applicable conditions are combined to calculate the total.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyarrayYesNo parameter description.—
request_body[].osstring | nullNoNo parameter description.—
request_body[].tagstring | nullNoNo parameter description.—
request_body[].urlstring | nullNoNo parameter description.—
request_body[].depthinteger | nullNoNo parameter description.—
request_body[].devicestring | nullNoNo parameter description.—
request_body[].targetstring | nullNoNo parameter description.—
request_body[].keywordstringNo<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 | nullNoNo parameter description.—
request_body[].search_paramstring | nullNoNo parameter description.—
request_body[].language_codestringNo<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_namestringNo<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_codeintegerNo<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_namestringNo<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 | nullNoNo parameter description.—
request_body[].location_coordinatestringNo<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 | nullNoNo parameter description.—
request_body[].stop_crawl_on_match[].match_typestring | nullNoNo parameter description.—
request_body[].stop_crawl_on_match[].match_valuestring | nullNoNo parameter description.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.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 exampleresponse.json
JSONPartial content
{
  "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."
}

This example shows part of the response. Copied content is valid JSON.