google-maps-scraper

Google Maps Scraper

Scrape business data from Google Maps at scale. Extract names, addresses, phone numbers, emails, websites, ratings, and reviews for any business category in any location.

When to Use

• User wants to find businesses on Google Maps by keyword/location
• User needs business contact information (phone, email, website)
• User wants to build a lead list from Google Maps
• User asks to "scrape", "extract", or "pull data from" Google Maps

Important: Credit System

Each search costs 2 credits. Free accounts start with 10 credits (5 searches). Always confirm before executing a search to avoid wasting credits.

Workflow

Step 1: Define Search (Don't Waste Credits)

Ask the user:

• Keywords: What type of business? Be SPECIFIC (e.g., "pediatric dentist" not just "dentist")
• Location: Where? (city + state/country for best results)
• Quantity: How many results needed?

Help them refine before searching:

• ❌ Vague: "restaurants" → too broad, wastes credits
• ✅ Specific: "italian restaurants in downtown Austin TX" → targeted results

Step 2: Confirm Before Executing

Before calling the API, ALWAYS tell the user:

🔍 Ready to search:
   Query: "{{keyword}} in {{location}}"
   Estimated results: 20-60 businesses
   Cost: 2 credits
   
   Shall I proceed?

Step 3: Execute Scrape

Only after user confirms:

curl -X POST "https://gmapsscraper.io/api/v1/scrape" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GMAPS_SCRAPER_API_KEY" \
  -d '{
    "keywords": ["{{keyword}} in {{location}}"],
    "email": true,
    "depth": 2
  }'

Step 4: Poll for Results

curl -s "https://gmapsscraper.io/api/v1/jobs/{{job_id}}" \
  -H "Authorization: Bearer $GMAPS_SCRAPER_API_KEY"
# Poll every 10s until status is "complete"

Step 5: Download Results

curl -s "https://gmapsscraper.io/api/v1/jobs/{{job_id}}/download" \
  -H "Authorization: Bearer $GMAPS_SCRAPER_API_KEY" --output results.csv