# Google Maps results for a keyword and location, live

DataForSEO

Live Google Maps SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Google Maps results for a keyword and location, live (tool ID: dataforseo.serp-google-maps-live-advanced). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Find local businesses](https://scrollport.com/tools/google-maps-scraper-api)

**Current price:** $0.0028/request

**Availability:** Ready to run

## Tool details

**About this tool**

Live Google Maps SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location. Request one bounded result or page using the documented fields. Pagination is explicit: follow-up pages require another run. The catalog price is the maximum per request; the upfront quote reflects the selected limits. Completed requests cost that quote, including valid empty pages and no-match answers. Supplier waivers do not change the customer price. Failed requests are uncharged. Results contain reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most the first item of each list.

**Inputs and outputs**

### Input

`keyword` string · required

Value supplied for keyword.

minLength: 1 · maxLength: 700

`language_code` string · optional

Value supplied for language code.

minLength: 1 · maxLength: 10

`location_code` integer · optional

Value supplied for location code.

minimum: 1 · maximum: 10000000

`search_places` boolean · optional

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

`search_this_area` boolean · optional

Value supplied for search this area.

### Output

`data` array

Returned data value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "dataforseo.serp-google-maps-live-advanced",
  "input": {
    "keyword": "albert einstein",
    "language_code": "en",
    "location_code": 2840
  }
}
```

### Output

```
{
  "data": [
    {
      "type": "maps",
      "items": [
        {
          "cid": "1797269780994265452",
          "url": "http://www.nasonline.org/about-nas/visiting-nas/nas-building/the-einstein-memorial.html",
          "type": "maps_search",
          "title": "Albert Einstein Memorial",
          "domain": "www.nasonline.org",
          "rating": {
            "value": 4.7
          },
          "category": "Memorial",
          "rank_group": 1,
          "rank_absolute": 1
        }
      ],
      "keyword": "albert einstein",
      "item_types": [
        "maps_search"
      ],
      "items_count": 100,
      "language_code": "en",
      "se_results_count": 0
    }
  ]
}
```

**Errors and limitations**

- `invalid_input`: The lookup fields or limits are invalid.example: {"keyword":"albert einstein","location_code":2840,"language_code":"en"}
- `upstream_error`: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

---

Canonical page: https://scrollport.com/tools/providers/dataforseo/serp-google-maps-live-advanced