{"id":42305693,"url":"https://github.com/apify/n8n-nodes-crawler-google-places","last_synced_at":"2026-01-27T11:08:43.911Z","repository":{"id":332749179,"uuid":"1128889060","full_name":"apify/n8n-nodes-crawler-google-places","owner":"apify","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-15T11:09:05.000Z","size":894,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T15:46:41.803Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apify.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-06T09:46:58.000Z","updated_at":"2026-01-15T11:09:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/apify/n8n-nodes-crawler-google-places","commit_stats":null,"previous_names":["apify/n8n-nodes-crawler-google-places"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/apify/n8n-nodes-crawler-google-places","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apify%2Fn8n-nodes-crawler-google-places","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apify%2Fn8n-nodes-crawler-google-places/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apify%2Fn8n-nodes-crawler-google-places/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apify%2Fn8n-nodes-crawler-google-places/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apify","download_url":"https://codeload.github.com/apify/n8n-nodes-crawler-google-places/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apify%2Fn8n-nodes-crawler-google-places/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28812371,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-27T07:41:26.337Z","status":"ssl_error","status_checked_at":"2026-01-27T07:41:08.776Z","response_time":168,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-27T11:08:43.203Z","updated_at":"2026-01-27T11:08:43.902Z","avatar_url":"https://github.com/apify.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# n8n Nodes - Google Maps Scraper\n\nThis is an n8n community node that integrates Apify's [Google Maps Scraper](https://apify.com/compass/crawler-google-places) with your n8n workflows, enabling you to extract structured data from Google Maps including business listings, reviews, and contact information.\n\n[Apify](https://apify.com) is a platform for developers to build, deploy, and publish web automation tools, while [n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) tool for AI workflow automation that allows you to connect various services.\n\n## Table of contents\n\n- [Installation on self hosted instance](#installation-self-hosted)\n- [Installation for development and contributing](#installation-development-and-contributing)\n- [Operations](#operations)\n- [Credentials](#credentials)\n- [Compatibility](#compatibility)\n- [Usage](#usage)\n- [Resources](#resources)\n- [Release](#releasing-a-new-version)\n- [Version History](#version-history)\n- [Troubleshooting](#troubleshooting)\n\n## Installation (self-hosted)\n\nTo install the Google Maps Scraper community node directly from the n8n Editor UI:\n\n1. Open your n8n instance.\n2. Go to **Settings \u003e Community Nodes**\n3. Select **Install**.\n4. Enter the npm package name: `n8n-nodes-crawler-google-places` to install the latest version. To install a specific version (e.g 1.0.0) enter `n8n-nodes-crawler-google-places@1.0.0`.\n5. Agree to the [risks](https://docs.n8n.io/integrations/community-nodes/risks/) of using community nodes and select **Install**\n6. The node is now available to use in your workflows.\n\n\u003e **Note:** This community node only works on self-hosted n8n instances. It is not available for n8n Cloud.\n\n## Installation (development and contributing)\n\n### ⚙️ Prerequisites\n\n- **Node.js**: 22.x or higher (required)\n- **npm**: 10.8.2 or higher (required)\n\nVerify your versions:\n\n```bash\nnode --version  # Should be v22.x.x or higher\nnpm --version   # Should be 10.8.2 or higher\n```\n\nIf you use `nvm`, the project includes a `.nvmrc` file. Simply run:\n\n```bash\nnvm use\n```\n\n### 1. Clone and install dependencies\n\nClone the repository and install dependencies:\n\n```bash\ngit clone https://github.com/apify/n8n-nodes-crawler-google-places.git\ncd n8n-nodes-crawler-google-places\nnpm install --legacy-peer-deps\n```\n\nThe `--legacy-peer-deps` flag is required due to n8n's complex peer dependency tree.\n\n### 2. Build the node package\n\n```bash\nnpm run build\n```\n\n### 3. Start development server\n\nStart the n8n development server with your node linked:\n\n```bash\nnpm run dev\n```\n\n---\n\n### 🔁 Making changes\n\nIf you make any changes to your custom node locally, remember to rebuild and restart:\n\n```bash\nnpm run build\n```\n\n---\n\n## Self-hosted n8n: public webhook URL for triggers\n\nThis configuration is required for our service's trigger functionality to work correctly.\n\nBy default, when running locally n8n generates webhook URLs using `localhost`, which external services cannot reach. To fix this:\n\n1. **Set your webhook URL**\nIn the same shell or Docker environment where n8n runs, export the `WEBHOOK_URL` to a publicly-accessible address. For example:\n  ```bash\n  export WEBHOOK_URL=\"https://your-tunnel.local\"\n  ```\n2. **Restart n8n**\n  ```bash\nnpm run dev\n  ```\n\n## Operations\n\nThis node provides three operations:\n\n### Scrape places with advanced options\n\nExtract comprehensive business data from Google Maps with full configuration options.\n\n**What you can extract:**\n- **Business information**: name, address, phone number, website, category\n- **Location data**: coordinates, plus code, neighborhood, city, state, country\n- **Ratings and reviews**: overall rating, number of reviews, review distribution\n- **Business details**: opening hours, popular times, services offered\n- **Photos**: business photos and images\n- **Additional attributes**: price level, wheelchair accessibility, payment options\n- **Business lead enrichment**: emails, social media profiles, contact details\n\n**Configuration options:**\n- Search by keyword, place name, or coordinates\n- Define search area with location and radius\n- Filter by category, rating, or price level\n- Set maximum number of results\n- Configure language and region preferences\n- Enable/disable images and photos extraction\n- Enable/disable reviews extraction\n\n### Scrape place reviews\n\nExtract customer reviews and ratings for specific places on Google Maps.\n\n**What you can extract:**\n- **Review content**: text, rating, date posted\n- **Reviewer information**: name, profile details, review count\n- **Review metrics**: likes count, response from owner\n- **Review photos**: images attached to reviews\n\n**Configuration options:**\n- Filter reviews by rating (1-5 stars)\n- Sort by newest, highest rating, or most relevant\n- Set maximum number of reviews to extract\n\n### Generate company and business leads\n\nExtract contact information and business leads from Google Maps listings.\n\n**What you can extract:**\n- **Contact details**: email addresses, phone numbers\n- **Business information**: company name, website, category\n- **Social media**: Facebook, Instagram, LinkedIn profiles\n- **Location data**: full address, coordinates\n- **Additional info**: business hours, ratings\n- **Employee data** (with business leads enrichment add-on): information about employees working at the business including:\n  - Personal details: first name, last name, LinkedIn profile\n  - Contact information: business email\n  - Professional info: job title, department, headline, seniority level\n  - Location: city, state, country\n  - Company details: company name, website, size, LinkedIn profile, industry\n\n**Configuration options:**\n- Search by keyword and location\n- Filter by business category\n- Search by place ID or place URL\n\n**AI integration:**\nThe Google Maps Scraper integrates seamlessly with n8n's AI tools, enabling workflows such as:\n- Extract business data and use AI to categorize or analyze market trends\n- Scrape reviews and generate sentiment analysis reports\n- Build lead lists and use AI to qualify prospects\n- Monitor competitor locations and generate strategic insights\n\n## Credentials\n\nThis node requires Apify API authentication:\n\n**API key authentication**\n- Configure your Apify API key in the n8n credentials section under `apifyApi`\n- You can find your API key in your [Apify account settings](https://console.apify.com/account/integrations)\n\n![auth](./docs/auth.png)\n\n\n## Compatibility\n\n- **n8n**: Version 1.57.0 and higher\n- **Node.js**: 22.x or higher\n- **npm**: 10.8.2 or higher\n\n## Usage\n\n### Basic setup\n\n1. **Install the node**: Follow the [installation instructions](#installation-self-hosted) above.\n2. **Configure credentials**: Add your Apify API key in n8n's credentials section.\n3. **Create a workflow**: Add the Google Maps Scraper node to your n8n workflow.\n4. **Select an operation**: Choose between scraping places, reviews, or generating leads.\n5. **Configure your search**:\n   - Enter your search query and location\n   - Select data extraction options\n   - Configure filters and limits\n6. **Execute the workflow**: Run the workflow to scrape Google Maps data.\n\n### Example use cases\n\n**Local business intelligence**\n- Extract competitor locations and business information\n- Monitor local market presence and density\n- Analyze business distribution across different areas\n- Track new business openings in specific locations\n\n**Lead generation and sales**\n- Build targeted business lead lists by category and location\n- Extract contact information for outreach campaigns\n- Generate prospect lists with business emails\n- Identify potential customers in specific geographic areas\n\n**Reputation management**\n- Monitor customer reviews across multiple locations\n- Track rating trends and sentiment over time\n- Analyze competitor reviews and feedback\n- Identify common customer complaints or praise\n\n**Market research**\n- Analyze popular times and business hours patterns\n- Compare pricing levels across competitors\n- Study service offerings and amenities\n- Identify market gaps and opportunities\n\n**Real estate and location analysis**\n- Assess business activity in specific neighborhoods\n- Evaluate commercial viability of locations\n- Map business categories and their distribution\n- Analyze foot traffic patterns through popular times data\n\n**Customer service and engagement**\n- Extract customer feedback for analysis\n- Identify businesses needing responses to reviews\n- Monitor brand mentions in reviews\n- Track customer sentiment across locations\n\n![workflow](./docs/workflow.png)\n\n## Resources\n\n- [Google Maps Scraper on Apify](https://apify.com/compass/crawler-google-places)\n- [n8n Community Nodes Documentation](https://docs.n8n.io/integrations/community-nodes/)\n- [Apify API Documentation](https://docs.apify.com)\n\n# Releasing a new version\n\nThis project uses a GitHub Actions workflow to automate the release process, including publishing to npm. Here's how to trigger a new release.\n\n**Prerequisites (for all methods):**\n\n* Ensure your target branch on GitHub is up-to-date with all changes you want to include in the release.\n* Decide on the new version number, following semantic versioning (e.g., `vX.Y.Z`).\n* Prepare your release notes detailing the changes.\n* If you're using CLI to release, make sure you have the [GitHub CLI (`gh`)](https://cli.github.com/) installed and authenticated (`gh auth login`).\n\n---\n\n## Method: Using the GitHub web UI (recommended for ease of use)\n\n1.  **Navigate to GitHub releases:**\n\t* Go to your repository's \"Releases\" tab\n\n2.  **Draft a new release:**\n\t* Click the **\"Draft a new release\"** button.\n\n3.  **Create or choose a tag:**\n\t* In the \"Choose a tag\" dropdown:\n\t\t* **Type your new tag name** (e.g., `v1.2.3`).\n\t\t* If the tag doesn't exist, GitHub will prompt you with an option like **\"Create new tag: v1.2.3 on publish.\"** Click this.\n\t\t* Ensure the **target branch** selected for creating the new tag is correct. This tag will point to the latest commit on this target branch.\n\n4.  **Set release title and notes:**\n\t* Set the \"Release title\" (e.g., `vX.Y.Z` or a more descriptive title).\n\t* For the release notes in the description field, you have a few options:\n\t\t* **Write your prepared release notes.**\n\t\t* **Click the \"Generate release notes\" button:** GitHub will attempt to automatically create release notes based on merged pull requests since the last release. You can then review and edit these auto-generated notes.\n\n5.  **Publish the release:**\n\t* Click the **\"Publish release\"** button.\n\n\t\t*Upon publishing, GitHub creates the tag from your specified branch and then creates the release. This \"published\" release event triggers the automated workflow.*\n\n---\n\n## Post-release: automated workflow \u0026 verification\n\nAfter creating and publishing the GitHub release:\n\n1.  **Automated workflow execution:**\n\t* The \"Release \u0026 Publish\" GitHub Actions workflow will automatically trigger.\n\t* It will perform:\n\t\t1.  Code checkout.\n\t\t2.  Version extraction (`X.Y.Z`) from the release tag.\n\t\t3.  Build and test processes.\n\t\t4.  Update `package.json` and `package-lock.json` to version `X.Y.Z`.\n\t\t5.  Commit these version changes back to the branch the release was targeted from with a message like `chore(release): set version to X.Y.Z [skip ci]`.\n\t\t6.  Publish the package `n8n-nodes-crawler-google-places@X.Y.Z` to npm.\n\n2.  **Verify the package on npm:**\n\t\tAfter the workflow successfully completes (check the \"Actions\" tab in your GitHub repository):\n\t* Verify the new version on npm:\n\t\t\t```bash\n\t\t\tnpm view n8n-nodes-crawler-google-places version\n\t\t\t```\n\t\tThis should print `X.Y.Z`.\n\n## Version history\n\nTrack changes and updates to the node here.\n\n## Troubleshooting\n\n### Common issues\n\n1. **Authentication errors**\n\t- Verify your API key is correct\n\n2. **Resource Not Found**\n\t- Verify the resource ID format\n\t- Check if the resource exists in your Apify account\n\t- Ensure you have access to the resource\n\n3. **Operation failures**\n\t- Check the input parameters\n\t- Verify resource limits (memory, timeout)\n\t- Review Apify Console for detailed error messages\n\n### Getting help\n\nIf you encounter issues:\n1. Check the [Google Maps Scraper documentation](https://apify.com/compass/crawler-google-places)\n2. Review the [Apify API documentation](https://docs.apify.com)\n3. Review the [n8n Community Nodes documentation](https://docs.n8n.io/integrations/community-nodes/)\n4. Open an issue in the GitHub repository\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapify%2Fn8n-nodes-crawler-google-places","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapify%2Fn8n-nodes-crawler-google-places","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapify%2Fn8n-nodes-crawler-google-places/lists"}