Back to Find local businesses

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.

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

keywordstring · required

Value supplied for keyword.

minLength: 1 · maxLength: 700

language_codestring · optional

Value supplied for language code.

minLength: 1 · maxLength: 10

location_codeinteger · optional

Value supplied for location code.

minimum: 1 · maximum: 10000000

search_placesboolean · 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_areaboolean · optional

Value supplied for search this area.

Output

dataarray

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.