DataForSEO SERP Bing Organic Live Advanced

Usage-based pricing
ae_dataforseo_serp_bing_organic_live_advanced

Get live Bing 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 metered amount (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<p><em>keyword</em><p><strong>required field</strong><p>you can specify <strong>up to 700 characters</strong> in the <code>keyword</code> field<p><strong>all %## will be decoded (plus character '+' will be decoded to a space character)</strong><p>if you need to use the "%" character for your <code>keyword</code>, please specify it as "%25";<p>if you need to use the “+” character for your <code>keyword</code>, please specify it as “%2B”;</p><br><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" target="_blank" rel="noopener noreferrer">Help Center article</a></p>—
request_body[].match_typestringNo<p><em>target match type</em><p><strong>required field if <code>stop_crawl_on_match</code> is specified</strong><p>type of match for the <code>match_value</code><p>possible values:<p><code>domain</code> – specific domain or subdomain<p><code>with_subdomains</code> – main domain and subdomains<p><code>wildcard</code> – wildcard pattern</p>—
request_body[].match_valuestringNo<p><em>target domain, subdomain, or wildcard value</em><p><strong>required field if <code>stop_crawl_on_match</code> is specified</strong><p>specify a target domain, subdomain, or wildcard value;<p><strong>Note:</strong> domain or subdomain must be specified without a request protocol;<p>example: <code>"match_value": "dataforseo.com"</code>,<p><code>"match_value": "/blog/post-*"</code></p>—
request_body[].search_paramstring | nullNoNo parameter description.—
request_body[].language_codestringNo<p><em>search engine language code</em><p><strong>required field if you don't specify</strong> <code>language_name</code><p><strong>if you use this field, you don't need to specify <code>language_name</code></strong><p>you can receive the list of available languages of the search engine with their <code>language_code</code>&nbsp;by making a separate request to the <code>https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages</code><em><p></em>example:<em><p></em><code class="long-string">en</code></p>—
request_body[].language_namestringNo<p><em>full name of search engine language</em><p><strong>required field if you don't specify</strong> <code>language_code</code><p><strong>if you use this field, you don't need to specify <code>language_code</code></strong><p>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><p>example:<p><code class="long-string">English</code></p>—
request_body[].location_codeintegerNo<p><em>search engine location code</em><p><strong>required field if you don't specify</strong> <code>location_name</code>&nbsp;or <code>location_coordinate</code><p><strong>if you use this field, you don't need to specify <code>location_name</code> or <code>location_coordinate</code></strong><p>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><p>example:<p><code class="long-string">2840</code></p>—
request_body[].location_namestringNo<p><em>full name of search engine location</em><p><strong>required field if you don't specify</strong> <code>location_code</code> or <code>location_coordinate</code><p><strong>if you use this field, you don't need to specify <code>location_code</code> or <code>location_coordinate</code></strong><p>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><p>example:<p><code class="long-string">London,England,United Kingdom</code></p>—
request_body[].max_crawl_pagesinteger | nullNoNo parameter description.—
request_body[].location_coordinatestringNo<p><em>GPS coordinates of a location</em><p><strong>required field if you don't specify</strong> <code>location_name</code>&nbsp;or <code>location_code</code><p><strong>if you use this field, you don't need to specify <code>location_name</code> or <code>location_code</code></strong><p><code>location_coordinate</code> parameter should be specified in the <em>"latitude,longitude"</em> format<p>the maximum number of decimal digits for <em>"latitude"</em> and <em>"longitude"</em>: 7<p>example:<p><code class="long-string">53.476225,-2.243572</code></p>—
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.—
request_body[].browser_screen_widthinteger | nullNoNo parameter description.—
request_body[].calculate_rectanglesboolean | nullNoNo parameter description.—
request_body[].browser_screen_heightinteger | nullNoNo parameter description.—
request_body[].browser_screen_resolution_ratiointeger | 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_bing_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_bing"
      }
    ]
  }
}'
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-de0f4bc9f611",
      "path": [
        "v3"
      ],
      "result": [
        {
          "check_url": "https://www.bing.com/search?q=AgentEarth&form=QBLH&cc=us",
          "datetime": "2026-11-15 07:35:55 +00:00",
          "item_types": [
            "organic"
          ],
          "items": [
            {}
          ],
          "items_count": 10,
          "type": "organic"
        }
      ],
      "result_count": 1,
      "status_code": 20000
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0,
  "time": "8.0041 sec."
}

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