DataForSEO SERP Google Organic Live Advanced
Get live Google organic search results through DataForSEO for a keyword and geographic location. Put task parameters in the request_body array according to this interface schema.
Pricing
The charge per call is (max(1200 × Actual billed search-task usage (USD), 0)) AE credits. All applicable conditions are combined to calculate the total.
Charges depend on the number of search tasks in the call, the search results pages actually crawled, and optional features such as calculating pixel positions of result elements, loading asynchronous AI Overviews, expanding People Also Ask results, or using special search operators. Increasing the requested depth or crawl-page limit may increase the actual crawl volume; settlement reflects the work performed. If an AI Overview is absent or is not loaded asynchronously, or People Also Ask is absent or fewer clicks are performed than requested, the corresponding unused surcharges are excluded from the final charge.
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 | keywordrequired fieldyou can specify up to 700 characters in the keyword fieldall %## will be decoded (plus character ‘+’ will be decoded to a space character)if you need to use the “%” character for your keyword, please specify it as “%25”;if you need to use the “+” character for your keyword, please specify it as “%2B”;if this field contains such parameters as ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, the charge per task will be multiplied by 5learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article | — |
request_body[].se_domain | string | null | No | No parameter description. | — |
request_body[].match_type | string | null | No | No parameter description. | — |
request_body[].match_value | string | null | No | No parameter description. | — |
request_body[].search_param | string | null | No | No parameter description. | — |
request_body[].language_code | string | null | No | No parameter description. | — |
request_body[].language_name | string | null | No | No parameter description. | — |
request_body[].location_code | integer | null | No | No parameter description. | — |
request_body[].location_name | string | null | No | No parameter description. | — |
request_body[].find_targets_in | array | null | No | No parameter description. | — |
request_body[].max_crawl_pages | integer | null | No | No parameter description. | — |
request_body[].remove_from_url | array | null | No | No parameter description. | — |
request_body[].ignore_targets_in | array | null | No | No parameter description. | — |
request_body[].target_search_mode | string | null | No | No parameter description. | — |
request_body[].location_coordinate | string | null | No | No parameter description. | — |
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[].group_organic_results | boolean | null | No | No parameter description. | — |
request_body[].load_async_ai_overview | boolean | null | No | No parameter description. | — |
request_body[].people_also_ask_click_depth | 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.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_serp_google_organic_live_advanced' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": [
{
"depth": 10,
"keyword": "custom mailer boxes",
"language_code": "en",
"location_code": 2840
}
]
}
}'{
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"data": {
"api": "serp",
"depth": 10,
"device": "desktop",
"function": "live",
"keyword": "custom mailer boxes",
"language_code": "en"
},
"id": "11180647-2802-0139-0000-f7d07f96f00f",
"path": [
"v3"
],
"result": [
{
"check_url": "https://www.google.com/search?q=custom%20mailer%20boxes&hl=en&gl=US&ie=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
"datetime": "2026-11-18 06:47:39 +00:00",
"item_types": [
"organic"
],
"items_count": 17,
"keyword": "custom mailer boxes",
"type": "organic"
}
],
"result_count": 1,
"status_code": 20000
}
],
"tasks_count": 1,
"tasks_error": 0,
"time": "6.8143 sec."
}This example shows part of the response. Copied content is valid JSON.



