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.
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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | array | Yes | No parameter description. | — |
request_body[].os | string | null | No | No parameter description. | — |
request_body[].tag | string | null | No | No parameter description. | — |
request_body[].url | string | null | No | No parameter description. | — |
request_body[].depth | integer | null | No | No parameter description. | — |
request_body[].device | string | null | No | No parameter description. | — |
request_body[].target | string | null | No | No parameter description. | — |
request_body[].keyword | string | No | <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_type | string | No | <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_value | string | No | <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_param | string | null | No | No parameter description. | — |
request_body[].language_code | string | No | <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> 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_name | string | No | <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_code | integer | No | <p><em>search engine location code</em><p><strong>required field if you don't specify</strong> <code>location_name</code> 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_name | string | No | <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_pages | integer | null | No | No parameter description. | — |
request_body[].location_coordinate | string | No | <p><em>GPS coordinates of a location</em><p><strong>required field if you don't specify</strong> <code>location_name</code> 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_match | array | null | No | No parameter description. | — |
request_body[].stop_crawl_on_match[].match_type | string | null | No | No parameter description. | — |
request_body[].stop_crawl_on_match[].match_value | string | null | No | No parameter description. | — |
request_body[].browser_screen_width | integer | null | No | No parameter description. | — |
request_body[].calculate_rectangles | boolean | null | No | No parameter description. | — |
request_body[].browser_screen_height | integer | null | No | No parameter description. | — |
request_body[].browser_screen_resolution_ratio | integer | null | No | No parameter description. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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.


