dataforseo_x_serp-google-maps-live-advanced $0.0025 per call

Google Maps results for a keyword and location, live. Live Google Maps SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location. (DataForSEO · Google Keyword Data)

POST https://toll402.dev/v1/p/dataforseo.x.serp-google-maps-live-advanced
{
 "language_code": "en",
 "location_code": 2840,
 "keyword": "albert einstein"
}

Input schema

{
 "type": "object",
 "properties": {
  "keyword": {
   "type": "string",
   "description": "keyword required field you can specify up to 700 characters in the keyword field all %## will be decoded (plus character '+' will be decoded to a space character) if you need to use the \"%\" character for your keyword , pl",
   "examples": [
    "albert einstein"
   ]
  },
  "location_code": {
   "type": "integer",
   "description": "search engine location code. Required field if you don't specify location_coordinate; 2840 = United States. Use location_code or location_coordinate; Live Maps rejects location_name with 40501 Invalid Field even though vendor docs list it.",
   "examples": [
    2840
   ]
  },
  "language_code": {
   "type": "string",
   "description": "search engine language code required field if you don't specify language_name if you use this field, you don't need to specify language_name you can receive the list of available languages of the search engine with their <",
   "examples": [
    "en"
   ]
  },
  "depth": {
   "type": "integer",
   "description": "parsing depth optional field number of results in SERP default value: 100 max value: 700 Your account will be billed per each SERP containing up to 100 results; Setting depth above 100 may result in additional charges <a href=\"h"
  },
  "device": {
   "type": "string",
   "description": "device type optional field return results for a specific device type can take the values: desktop , mobile default value: desktop note: for mobile device, only 20 results are returned for every SERP"
  },
  "language_name": {
   "type": "string",
   "description": "full name of search engine language required field if you don't specify language_code if you use this field, you don't need to specify language_code you can receive the list of available languages of the search engine with"
  },
  "os": {
   "type": "string",
   "description": "device operating system optional field if you specify desktop in the device field, choose from the following values: windows , macos default value: windows if you specify mobile in the device</code"
  },
  "tag": {
   "type": "string",
   "description": "user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response"
  },
  "max_crawl_pages": {
   "type": "integer",
   "description": "page crawl limit optional field number of search results pages to crawl max value: 100 Note: the max_crawl_pages and depth parameters complement each other; learn more at <a href=\"https://dataforseo.com/help-center/what-is"
  },
  "url": {
   "type": "string",
   "description": "direct URL of the search query optional field you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact langua"
  },
  "location_coordinate": {
   "type": "string",
   "description": "GPS coordinates of a location. Required field if you don't specify location_code. Use location_code or location_coordinate; Live Maps rejects location_name with 40501 Invalid Field even though vendor docs list it."
  },
  "se_domain": {
   "type": "string",
   "description": "search engine domain optional field we choose the relevant search engine domain automatically according to the location and language you specify however, you can set a custom search engine domain in this field example: google.co.uk , google"
  },
  "search_this_area": {
   "type": "boolean",
   "description": "show results from the displayed area optional field can take the values: true , false default value: true if set to false , the search_this_area mode will be turned off Note: if the <"
  },
  "search_places": {
   "type": "boolean",
   "description": "search places mode optional field the search places mode allows to obtain Google Maps results on a certain place (e.g., Apple Store in New York) however, due to the pecularities of our data mining algorithm, this mode might interfere with s"
  }
 },
 "additionalProperties": true,
 "description": "the POST body is an ARRAY of task objects with these fields — one object per task. Use location_code or location_coordinate; do not send location_name (live API returns 40501 Invalid Field even though vendor docs list it)."
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI