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.

Capability: Local business search
Current price: $0.0028/call
Availability: Ready to run

What this API does

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 quote reflects the selected limits and the wallet settles the verified actual cost plus 40%. Free supplier calls remain free. 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.

Agents select this operation with tool ID dataforseo.serp-google-maps-live-advanced, then check its current inputs and price before a run.

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.

Use Google Maps results for a keyword and location, live with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.