DataForSEO SERP Google Organic Live Advanced

Usage-based pricing
ae_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.

Search
Usage-based pricing

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.

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[].keywordstringNokeywordrequired 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_domainstring | nullNoNo parameter description.—
request_body[].match_typestring | nullNoNo parameter description.—
request_body[].match_valuestring | nullNoNo parameter description.—
request_body[].search_paramstring | nullNoNo parameter description.—
request_body[].language_codestring | nullNoNo parameter description.—
request_body[].language_namestring | nullNoNo parameter description.—
request_body[].location_codeinteger | nullNoNo parameter description.—
request_body[].location_namestring | nullNoNo parameter description.—
request_body[].find_targets_inarray | nullNoNo parameter description.—
request_body[].max_crawl_pagesinteger | nullNoNo parameter description.—
request_body[].remove_from_urlarray | nullNoNo parameter description.—
request_body[].ignore_targets_inarray | nullNoNo parameter description.—
request_body[].target_search_modestring | nullNoNo parameter description.—
request_body[].location_coordinatestring | nullNoNo parameter description.—
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[].group_organic_resultsboolean | nullNoNo parameter description.—
request_body[].load_async_ai_overviewboolean | nullNoNo parameter description.—
request_body[].people_also_ask_click_depthinteger | 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_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
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.