google-maps-scraper

Query the Maps Data API to discover Google Maps businesses and export structured results to CSV.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/nimajnebrevilo/GTM-Engine --skill google-maps-scraper-nimajnebrevilo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-maps-scraper
Source: https://github.com/nimajnebrevilo/GTM-Engine/tree/main/skills/google-maps-scraper
Command: npx skills add https://github.com/nimajnebrevilo/GTM-Engine --skill google-maps-scraper-nimajnebrevilo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bottleneck.

What problem does it solve?

Automates discovering Google Maps businesses by querying the Maps Data API and returns structured results (name, address, phone, website, rating, reviews, coordinates).

Core Features & Use Cases

  • Works as a local CLI or can be deployed as a web app.
  • Uses the RapidAPI Maps Data API and requires a RapidAPI key.
  • Returns structured place data including name, address, lat/lng, rating, reviews, phone, and website.
  • Supports multi-location searches via zips, cities, or state, with optional minimum population filtering for state scopes.
  • Exports results to CSV for downstream analysis and reporting.

Quick Start

Run the scraper to search for a query in a location and export the results to a CSV file.

Frequently Asked Questions about google-maps-scraper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I extract business data from Google Maps for a specific location?

To extract Google Maps business data, you query the Maps Data API with a specific search term and location. This process compiles structured business details like names, addresses, phone numbers, and coordinates into a usable format for analysis.

What do I need to scrape Google Maps places using a CLI tool?

To scrape Google Maps places, you need a valid RapidAPI Maps Data API key and Node.js 18+ installed. The environment manages API rate limits and retries automatically to ensure successful data extraction.

Can I export scraped Google Maps data to a CSV file?

Yes, you can export scraped Google Maps data to a CSV file. Once the API query finishes, the extracted place data is structured and exported for downstream analysis, reporting, and integration into your existing datasets.

How do I find businesses across multiple cities or states at once?

You can find businesses across multiple cities or states by providing a list of zips, cities, or state scopes in your query. State scopes also support optional minimum population filtering to target specific demographics.

Why does my Google Maps web scraping keep failing due to API limits?

Google Maps API scraping fails when exceeding rate limits. This tool uses the Bottleneck dependency to enforce proper rate limiting with retries, managing API limits automatically to prevent failed requests during data extraction.