GeoScraper Google Map Scraper icon

GeoScraper Google Map Scraper

Unified node for GeoScraper Google Map Scraper operations

Overview

This node, "GeoScraper Google Map Scraper," enables scraping of various types of data from Google Maps through the GeoScraper API. It supports multiple operations including searching map results, searching places, retrieving details for a single place, and scraping reviews.

The Place Search operation specifically allows users to search for places on Google Maps based on a location (coordinates with zoom level) and a query string (e.g., "hotels"). This is useful for gathering structured information about businesses or points of interest in a specific area.

Practical examples:

  • Finding all restaurants within a certain city or neighborhood.
  • Searching for hotels near a given coordinate.
  • Collecting data on stores or services available in a particular region.

Properties

Name Meaning
Location Name or Coordinates (ll) Coordinates and zoom level in the format @latitude,longitude,zoomz. Defines the geographic area to search within.
Query (query) The search query string, e.g., "hotels in usa". Specifies what type of places to look for.
Language (hl) Language code (e.g., "en") to specify the language of the response data.
Use Cached (catched) Boolean flag indicating whether to use cached data if available, improving performance by avoiding repeated requests.

Output

The output is an array of JSON objects representing the search results returned by the GeoScraper API for the Place Search operation. Each item corresponds to a place matching the query within the specified location.

  • If multiple results are returned, each is output as a separate JSON object.
  • If no results are found, the node outputs a JSON object with a message indicating "No more results" and detail "No data found".
  • The output does not include binary data.

Example output snippet:

[
  {
    "json": {
      "name": "Hotel Example",
      "address": "123 Example St, City, Country",
      "place_id": "ChIJxxxxxx",
      "rating": 4.5,
      "reviews_count": 120,
      ...
    }
  },
  ...
]

Dependencies

  • Requires an API token credential for the GeoScraper service.
  • Makes HTTP POST requests to the GeoScraper API endpoints.
  • No additional environment variables are needed beyond the API token credential configured in n8n.

Troubleshooting

  • Common issues:

    • Missing or invalid API token will cause authentication errors.
    • Incorrectly formatted coordinates or missing query parameters may result in empty or error responses.
    • Network connectivity issues can cause request failures.
  • Error messages:

    • "You must provide a value for the selected ID type." — occurs if required identifiers are missing for operations other than Place Search; not applicable here but indicates parameter validation.
    • "No more results" with detail "No data found" — indicates that the search yielded no results; this is normal when no matches exist.
    • Other HTTP errors from the API will be surfaced unless "Continue On Fail" is enabled, in which case errors are returned as JSON objects per item.

Links and References


This summary focuses on the Place Search operation of the GeoScraper Google Map Scraper node as requested.

Discussion