Deploy Your Own Maps Scraping API in 5 Minutes

21 Mar, 2026

The maps-scraper now has a SaaS mode: multi-user, REST API, admin UI, job queue. One command to deploy on your own VPS.

Why

The CLI works fine for one person. But if you need multiple users, an API to integrate with, or a dashboard to manage jobs — you need something more.

The new SaaS Edition adds that on top of the same scraper. Same repo, same MIT license.

You get:

REST API with Swagger docs
Admin UI with API key management and 2FA
Job queue with worker management
One-command deploy and updates

Video

Full walkthrough here:

What You Need

Docker on your local machine — the provisioner runs from your computer and handles everything remotely
An account on Hetzner or DigitalOcean — the provisioner creates and configures the server for you automatically

You don't need to create a VPS yourself. The wizard handles that.

I recommend Hetzner — good machines, fair pricing, and you get €20 free credit when you sign up with this link. DigitalOcean works too, with $200 free credit for 60 days.

Deploy

On your local machine, run:

curl -fsSL https://raw.githubusercontent.com/gosom/google-maps-scraper/main/PROVISION | sh

The interactive wizard runs locally and provisions your remote VPS. It walks you through image selection, cloud provider, database setup, and admin user creation. State is saved to ~/.gmapssaas/ so you can resume if interrupted.

Takes about 5 minutes.

Admin UI

Go to https://your-server and log in with the credentials from the wizard.

From there you can create API keys, monitor jobs, manage workers, and set up 2FA.

API

Create an API key in the admin UI, then:

Submit a job:

curl -X POST https://your-server/api/v1/scrape \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "restaurants in New York", "lang": "en", "max_depth": 10}'

List completed jobs:

curl https://your-server/api/v1/jobs?state=completed \
  -H "X-API-Key: your-api-key"

Get job results:

curl https://your-server/api/v1/jobs/{job_id} \
  -H "X-API-Key: your-api-key"

Full docs at /swagger/ on your instance.

Update

curl -fsSL https://raw.githubusercontent.com/gosom/google-maps-scraper/main/PROVISION | sh -s update

Proxies

For anything beyond light usage, you'll want proxies. The scraper supports SOCKS5, HTTP, and HTTPS.

I use Webshare — they have a free tier to get started and reasonable pricing after that.

Feedback

This is in beta. If you hit issues or have ideas, open an issue or join the Discord.

If the project is useful to you, a star helps others find it.

Need Help?

If you need help deploying, customizing, or integrating the scraper into your workflow, book a call.

Disclaimer

This software is provided as-is under the MIT License. You are solely responsible for ensuring your use complies with all applicable laws and regulations. Web scraping may violate the terms of service of third-party websites. The author does not endorse or encourage any unlawful use. By using this software you accept full responsibility for your usage.