google-maps-leads-scraper 0.1.0__tar.gz

google_maps_leads_scraper-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Buğrahan Saka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

google_maps_leads_scraper-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md LICENSE
+recursive-include tests *.py *.json
+recursive-include examples *.py

google_maps_leads_scraper-0.1.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: google-maps-leads-scraper
+Version: 0.1.0
+Summary: Export Google Maps businesses (name, phone, website, address, rating, hours, coordinates), place details and reviews to CSV with Python and the Scrape.do Google Maps API.
+Author: Buğrahan Saka
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/bugrahansss/google-maps-leads-scraper
+Project-URL: Source, https://github.com/bugrahansss/google-maps-leads-scraper
+Project-URL: Issues, https://github.com/bugrahansss/google-maps-leads-scraper/issues
+Project-URL: Guide, https://scrape.do/blog/google-maps-scraping/
+Keywords: google maps,google maps scraper,lead generation,web scraping,places,reviews,scrapedo
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25
+Dynamic: license-file
+
+# Google Maps Leads Scraper
+
+[![PyPI](https://img.shields.io/pypi/v/google-maps-leads-scraper)](https://pypi.org/project/google-maps-leads-scraper/)
+[![Python](https://img.shields.io/pypi/pyversions/google-maps-leads-scraper)](https://pypi.org/project/google-maps-leads-scraper/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+Turn a Google Maps search into a lead list. Give it a query and a point on the map; get back every business with its **name, phone, website, address, rating, review count, opening hours, coordinates and place ID**, as JSON or CSV. It can also pull a single place's full details (rating breakdown, plus code, attributes) and its **reviews** with owner replies.
+
+It runs on the [Scrape.do Google Maps API](https://scrape.do/?utm_source=github&utm_medium=readme&utm_campaign=google-maps-leads-scraper), which returns parsed JSON, so there is no HTML, protobuf or browser automation to maintain.
+
+```bash
+pip install google-maps-leads-scraper
+export SCRAPEDO_TOKEN=your_token
+google-maps-leads-scraper search "coffee shop" --ll 30.2672,-97.7431 --pages 6 -f csv -o austin-coffee.csv
+```
+
+```
+ok    'coffee shop' @ 30.2672,-97.7431: 104 place(s)
+104 record(s), 60 credits used, saved to austin-coffee.csv
+```
+
+## Why not just request google.com/maps?
+
+Google Maps is a JavaScript app. The page you get from `requests` has no business data in it, and the internal endpoints the app calls (`/search?tbm=map`, `/maps/preview/place`) answer in a nested protobuf-over-JSON array with an anti-XSSI prefix and no stable field names. Scripts that send many of them meet the consent wall, CAPTCHAs and rate limits, and the reviews endpoint most old tutorials used (`listentitiesreviews`) has been retired.
+
+The Scrape.do Google Maps API makes the request from a residential IP and returns clean JSON:
+
+| Endpoint | Input | Returns |
+| --- | --- | --- |
+| `/plugin/google/maps/search` | `q`, `ll`, `start` | 20 places per page, about 120 per query |
+| `/plugin/google/maps/place` | `place_id` or `data_cid` | one place with hours, rating breakdown, attributes |
+| `/plugin/google/maps/reviews` | `data_id` or `place_id`, `sort_by` | about 10 reviews per page, owner replies, topics |
+
+Every successful call costs 10 credits, so a full page of 20 leads costs 10 credits and 1,000 leads cost about 500. The free plan has 1,000 credits a month.
+
+## Command line
+
+```bash
+# One query around a point, 6 pages (the ~120 place maximum)
+google-maps-leads-scraper search "plumber" --ll 40.7128,-74.0060 --pages 6 -f csv -o nyc-plumbers.csv
+
+# The location can be in the query instead
+google-maps-leads-scraper search "vegan restaurant in Lisbon" --gl pt
+
+# Several queries across several points, merged without duplicates
+google-maps-leads-scraper search "dentist" "orthodontist" \
+  --ll 30.2672,-97.7431 --ll 30.3072,-97.7559 --pages 2 -f csv -o dentists.csv
+
+# Full details for places
+google-maps-leads-scraper place ChIJ_UbNVbC1RIYRTavD-VMmvZA
+
+# Reviews, newest first, two pages
+google-maps-leads-scraper reviews --data-id 0x8644b5b055cd46fd:0x90bd2653f9c3ab4d --sort newest --pages 2 -f csv -o reviews.csv
+```
+
+`--ll` takes `lat,lng`, `lat,lng,zoom` or the `@lat,lng,14z` form from a Maps URL. `search --details` also fetches every place's detail page (10 more credits per place).
+
+## Python
+
+```python
+from google_maps_leads_scraper import GoogleMapsScraper
+
+maps = GoogleMapsScraper(token="YOUR_SCRAPEDO_TOKEN")  # or set SCRAPEDO_TOKEN
+
+places = maps.search("coffee shop", ll="30.2672,-97.7431", pages=3)
+for p in places[:3]:
+    print(p.name, p.rating, p.reviews, p.phone, p.website)
+
+details = maps.place(places[0].place_id)
+print(details.hours)              # Mon: 7 AM–2 PM; Tue: 7 AM–2 PM; ...
+print(details.rating_breakdown)   # {'1': 16, '2': 6, '3': 14, '4': 41, '5': 604}
+
+for review in maps.reviews(data_id=places[0].data_id, sort_by="lowest_rating", pages=2):
+    print(review.rating, review.date, review.text[:80], "| reply:", bool(review.owner_reply))
+
+print(maps.credits_used)
+```
+
+To cover a whole city, run the query around several points; `search_grid` does that and drops duplicates by place ID. See [`examples/leads_grid.py`](examples/leads_grid.py).
+
+## Output fields
+
+**Places:** `name`, `category`, `categories`, `rating`, `reviews`, `phone`, `website`, `address`, `latitude`, `longitude`, `hours`, `open_state`, `place_id`, `data_id`, `data_cid`, `plus_code`, `thumbnail`, `maps_url`. JSON output adds `rating_breakdown` and `attributes` (accessibility, service options and so on).
+
+**Reviews:** `place_id`, `data_id`, `review_id`, `rating`, `date`, `iso_date`, `text`, `likes`, `author`, `author_reviews`, `local_guide`, `owner_reply`, `owner_reply_date`, `link`.
+
+`place_id` feeds `place`; `data_id` feeds `reviews`.
+
+## Use it responsibly
+
+Business listings are public, but reviews carry the names of the people who wrote them. Store only what you need, follow the privacy rules that apply to you (GDPR, CCPA), respect opt-outs before cold outreach, and read Google's terms for your use case.
+
+## Also available
+
+- **No-code:** [Google Maps Leads Scraper on Apify](https://apify.com/scrapedo/google-maps-leads-scraper)
+- **Browser demo:** [Hugging Face Space](https://huggingface.co/spaces/bugrahans/google-maps-leads-scraper)
+- **Full guide:** [Google Maps Scraper: How to Scrape Google Maps for Leads](https://scrape.do/blog/google-maps-scraping/?utm_source=github&utm_medium=readme&utm_campaign=google-maps-leads-scraper), including the raw Python approach without the API
+
+## Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+The fixtures are made-up businesses on example.com; the tests never hit the network.
+
+## License
+
+MIT

google_maps_leads_scraper-0.1.0/README.md

@@ -0,0 +1,109 @@
+# Google Maps Leads Scraper
+
+[![PyPI](https://img.shields.io/pypi/v/google-maps-leads-scraper)](https://pypi.org/project/google-maps-leads-scraper/)
+[![Python](https://img.shields.io/pypi/pyversions/google-maps-leads-scraper)](https://pypi.org/project/google-maps-leads-scraper/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+Turn a Google Maps search into a lead list. Give it a query and a point on the map; get back every business with its **name, phone, website, address, rating, review count, opening hours, coordinates and place ID**, as JSON or CSV. It can also pull a single place's full details (rating breakdown, plus code, attributes) and its **reviews** with owner replies.
+
+It runs on the [Scrape.do Google Maps API](https://scrape.do/?utm_source=github&utm_medium=readme&utm_campaign=google-maps-leads-scraper), which returns parsed JSON, so there is no HTML, protobuf or browser automation to maintain.
+
+```bash
+pip install google-maps-leads-scraper
+export SCRAPEDO_TOKEN=your_token
+google-maps-leads-scraper search "coffee shop" --ll 30.2672,-97.7431 --pages 6 -f csv -o austin-coffee.csv
+```
+
+```
+ok    'coffee shop' @ 30.2672,-97.7431: 104 place(s)
+104 record(s), 60 credits used, saved to austin-coffee.csv
+```
+
+## Why not just request google.com/maps?
+
+Google Maps is a JavaScript app. The page you get from `requests` has no business data in it, and the internal endpoints the app calls (`/search?tbm=map`, `/maps/preview/place`) answer in a nested protobuf-over-JSON array with an anti-XSSI prefix and no stable field names. Scripts that send many of them meet the consent wall, CAPTCHAs and rate limits, and the reviews endpoint most old tutorials used (`listentitiesreviews`) has been retired.
+
+The Scrape.do Google Maps API makes the request from a residential IP and returns clean JSON:
+
+| Endpoint | Input | Returns |
+| --- | --- | --- |
+| `/plugin/google/maps/search` | `q`, `ll`, `start` | 20 places per page, about 120 per query |
+| `/plugin/google/maps/place` | `place_id` or `data_cid` | one place with hours, rating breakdown, attributes |
+| `/plugin/google/maps/reviews` | `data_id` or `place_id`, `sort_by` | about 10 reviews per page, owner replies, topics |
+
+Every successful call costs 10 credits, so a full page of 20 leads costs 10 credits and 1,000 leads cost about 500. The free plan has 1,000 credits a month.
+
+## Command line
+
+```bash
+# One query around a point, 6 pages (the ~120 place maximum)
+google-maps-leads-scraper search "plumber" --ll 40.7128,-74.0060 --pages 6 -f csv -o nyc-plumbers.csv
+
+# The location can be in the query instead
+google-maps-leads-scraper search "vegan restaurant in Lisbon" --gl pt
+
+# Several queries across several points, merged without duplicates
+google-maps-leads-scraper search "dentist" "orthodontist" \
+  --ll 30.2672,-97.7431 --ll 30.3072,-97.7559 --pages 2 -f csv -o dentists.csv
+
+# Full details for places
+google-maps-leads-scraper place ChIJ_UbNVbC1RIYRTavD-VMmvZA
+
+# Reviews, newest first, two pages
+google-maps-leads-scraper reviews --data-id 0x8644b5b055cd46fd:0x90bd2653f9c3ab4d --sort newest --pages 2 -f csv -o reviews.csv
+```
+
+`--ll` takes `lat,lng`, `lat,lng,zoom` or the `@lat,lng,14z` form from a Maps URL. `search --details` also fetches every place's detail page (10 more credits per place).
+
+## Python
+
+```python
+from google_maps_leads_scraper import GoogleMapsScraper
+
+maps = GoogleMapsScraper(token="YOUR_SCRAPEDO_TOKEN")  # or set SCRAPEDO_TOKEN
+
+places = maps.search("coffee shop", ll="30.2672,-97.7431", pages=3)
+for p in places[:3]:
+    print(p.name, p.rating, p.reviews, p.phone, p.website)
+
+details = maps.place(places[0].place_id)
+print(details.hours)              # Mon: 7 AM–2 PM; Tue: 7 AM–2 PM; ...
+print(details.rating_breakdown)   # {'1': 16, '2': 6, '3': 14, '4': 41, '5': 604}
+
+for review in maps.reviews(data_id=places[0].data_id, sort_by="lowest_rating", pages=2):
+    print(review.rating, review.date, review.text[:80], "| reply:", bool(review.owner_reply))
+
+print(maps.credits_used)
+```
+
+To cover a whole city, run the query around several points; `search_grid` does that and drops duplicates by place ID. See [`examples/leads_grid.py`](examples/leads_grid.py).
+
+## Output fields
+
+**Places:** `name`, `category`, `categories`, `rating`, `reviews`, `phone`, `website`, `address`, `latitude`, `longitude`, `hours`, `open_state`, `place_id`, `data_id`, `data_cid`, `plus_code`, `thumbnail`, `maps_url`. JSON output adds `rating_breakdown` and `attributes` (accessibility, service options and so on).
+
+**Reviews:** `place_id`, `data_id`, `review_id`, `rating`, `date`, `iso_date`, `text`, `likes`, `author`, `author_reviews`, `local_guide`, `owner_reply`, `owner_reply_date`, `link`.
+
+`place_id` feeds `place`; `data_id` feeds `reviews`.
+
+## Use it responsibly
+
+Business listings are public, but reviews carry the names of the people who wrote them. Store only what you need, follow the privacy rules that apply to you (GDPR, CCPA), respect opt-outs before cold outreach, and read Google's terms for your use case.
+
+## Also available
+
+- **No-code:** [Google Maps Leads Scraper on Apify](https://apify.com/scrapedo/google-maps-leads-scraper)
+- **Browser demo:** [Hugging Face Space](https://huggingface.co/spaces/bugrahans/google-maps-leads-scraper)
+- **Full guide:** [Google Maps Scraper: How to Scrape Google Maps for Leads](https://scrape.do/blog/google-maps-scraping/?utm_source=github&utm_medium=readme&utm_campaign=google-maps-leads-scraper), including the raw Python approach without the API
+
+## Tests
+
+```bash
+python -m unittest discover -s tests
+```
+
+The fixtures are made-up businesses on example.com; the tests never hit the network.
+
+## License
+
+MIT

google_maps_leads_scraper-0.1.0/examples/leads_grid.py

@@ -0,0 +1,31 @@
+"""Build a lead list for one category across a small grid of points in Austin, TX.
+
+One Google Maps query stops at about 120 places, so a city-wide list repeats
+the query around several centre points and drops the duplicates.
+
+    export SCRAPEDO_TOKEN=...
+    python examples/leads_grid.py
+"""
+
+import csv
+
+from google_maps_leads_scraper import PLACE_FIELDS, GoogleMapsScraper
+
+POINTS = [
+    "30.2672,-97.7431",  # downtown
+    "30.3072,-97.7559",  # north central
+    "30.2240,-97.7690",  # south
+]
+
+maps = GoogleMapsScraper()  # reads SCRAPEDO_TOKEN
+places = maps.search_grid(["dentist"], POINTS, pages=2)
+
+# Keep the ones a sales team can actually contact
+leads = [p for p in places if p.phone or p.website]
+
+with open("austin-dentists.csv", "w", newline="", encoding="utf-8") as handle:
+    writer = csv.DictWriter(handle, fieldnames=PLACE_FIELDS)
+    writer.writeheader()
+    writer.writerows(p.to_row() for p in leads)
+
+print(f"{len(leads)} leads from {len(places)} places, {maps.credits_used} credits")

google_maps_leads_scraper-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "google-maps-leads-scraper"
+version = "0.1.0"
+description = "Export Google Maps businesses (name, phone, website, address, rating, hours, coordinates), place details and reviews to CSV with Python and the Scrape.do Google Maps API."
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Buğrahan Saka" }]
+keywords = ["google maps", "google maps scraper", "lead generation", "web scraping", "places", "reviews", "scrapedo"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+]
+dependencies = ["requests>=2.25"]
+
+[project.urls]
+Homepage = "https://github.com/bugrahansss/google-maps-leads-scraper"
+Source = "https://github.com/bugrahansss/google-maps-leads-scraper"
+Issues = "https://github.com/bugrahansss/google-maps-leads-scraper/issues"
+Guide = "https://scrape.do/blog/google-maps-scraping/"
+
+[project.scripts]
+google-maps-leads-scraper = "google_maps_leads_scraper.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

google_maps_leads_scraper-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

google_maps_leads_scraper-0.1.0/src/google_maps_leads_scraper/__init__.py

@@ -0,0 +1,21 @@
+"""Export Google Maps businesses, place details and reviews with Python and the Scrape.do Google Maps API."""
+
+from .client import GoogleMapsScraper, ScrapeError
+from .models import PLACE_FIELDS, REVIEW_FIELDS, Place, Review, dedupe, format_hours, format_ll, parse_place, parse_reviews, parse_search
+
+__all__ = [
+    "GoogleMapsScraper",
+    "PLACE_FIELDS",
+    "Place",
+    "REVIEW_FIELDS",
+    "Review",
+    "ScrapeError",
+    "dedupe",
+    "format_hours",
+    "format_ll",
+    "parse_place",
+    "parse_reviews",
+    "parse_search",
+]
+
+__version__ = "0.1.0"

google_maps_leads_scraper-0.1.0/src/google_maps_leads_scraper/cli.py

@@ -0,0 +1,141 @@
+"""Command line entry point.
+
+    google-maps-leads-scraper search "coffee shop" --ll 30.2672,-97.7431 --pages 3 -f csv -o leads.csv
+    google-maps-leads-scraper place ChIJ...
+    google-maps-leads-scraper reviews --data-id 0x...:0x... --sort newest --pages 2
+"""
+
+from __future__ import annotations
+
+import argparse
+import csv
+import json
+import sys
+from typing import Any, Dict, List, Optional
+
+from . import __version__
+from .client import SORT_OPTIONS, TOKEN_ENV, GoogleMapsScraper, ScrapeError
+from .models import PLACE_FIELDS, REVIEW_FIELDS, dedupe
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="google-maps-leads-scraper",
+        description="Export Google Maps businesses and reviews to JSON or CSV through the Scrape.do Google Maps API.",
+    )
+    parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}")
+    common = argparse.ArgumentParser(add_help=False)
+    common.add_argument("-t", "--token", help=f"Scrape.do API token (default: ${TOKEN_ENV})")
+    common.add_argument("--gl", default="us", help="Country code for results (default: us)")
+    common.add_argument("--hl", default="en", help="Language code (default: en)")
+    common.add_argument("-f", "--format", choices=("json", "csv"), default="json", help="Output format (default: json)")
+    common.add_argument("-o", "--output", help="Write to this file instead of stdout")
+
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    search = sub.add_parser("search", parents=[common], help="Businesses for one or more queries")
+    search.add_argument("queries", nargs="+", help='Search terms, e.g. "dentist" or "coffee shop in Austin, TX"')
+    search.add_argument("--ll", action="append", default=[], help="Centre point lat,lng (repeatable for a grid)")
+    search.add_argument("--zoom", type=float, default=14, help="Map zoom for --ll (default: 14)")
+    search.add_argument("--pages", type=int, default=1, help="Pages per query and point, 20 places each, max 6 (default: 1)")
+    search.add_argument("--details", action="store_true", help="Also fetch each place's details (10 credits per place)")
+
+    place = sub.add_parser("place", parents=[common], help="Details for places by place_id")
+    place.add_argument("place_ids", nargs="*", help="Google place IDs (ChIJ...)")
+    place.add_argument("--cid", action="append", default=[], help="Look up by data_cid instead (repeatable)")
+
+    reviews = sub.add_parser("reviews", parents=[common], help="Reviews for one place")
+    target = reviews.add_mutually_exclusive_group(required=True)
+    target.add_argument("--data-id", help="Feature ID, e.g. 0x8644b5b055cd46fd:0x90bd2653f9c3ab4d")
+    target.add_argument("--place-id", help="Google place ID (ChIJ...)")
+    reviews.add_argument("--sort", choices=SORT_OPTIONS, default="newest", help="Review order (default: newest)")
+    reviews.add_argument("--pages", type=int, default=1, help="Review pages, about 10 each (default: 1)")
+    reviews.add_argument("--query", default="", help="Only reviews that mention this word")
+    return parser
+
+
+def _write(rows: List[Dict[str, Any]], records: List[Dict[str, Any]], fields: List[str], fmt: str, output: Optional[str]) -> None:
+    stream = open(output, "w", encoding="utf-8", newline="" if fmt == "csv" else None) if output else sys.stdout
+    try:
+        if fmt == "csv":
+            writer = csv.DictWriter(stream, fieldnames=fields, extrasaction="ignore")
+            writer.writeheader()
+            writer.writerows(rows)
+        else:
+            json.dump(records, stream, indent=2, ensure_ascii=False)
+            stream.write("\n")
+    finally:
+        if output:
+            stream.close()
+
+
+def main(argv: Optional[List[str]] = None) -> int:
+    args = build_parser().parse_args(argv)
+    try:
+        maps = GoogleMapsScraper(token=args.token, gl=args.gl, hl=args.hl)
+    except ValueError as exc:
+        print(exc, file=sys.stderr)
+        return 2
+
+    failures = 0
+    if args.command == "search":
+        places = []
+        for query in args.queries:
+            for point in args.ll or [None]:
+                label = f"{query!r}" + (f" @ {point}" if point else "")
+                try:
+                    found = maps.search(query, ll=point, pages=args.pages, zoom=args.zoom)
+                except (ScrapeError, ValueError) as exc:
+                    failures += 1
+                    print(f"fail  {label}: {exc}", file=sys.stderr)
+                    continue
+                print(f"ok    {label}: {len(found)} place(s)", file=sys.stderr)
+                places.extend(found)
+        places = dedupe(places)
+        if args.details:
+            detailed = []
+            for p in places:
+                try:
+                    detailed.append(maps.place(p.place_id, p.data_cid) if (p.place_id or p.data_cid) else p)
+                except (ScrapeError, ValueError) as exc:
+                    print(f"fail  details {p.name}: {exc}", file=sys.stderr)
+                    detailed.append(p)
+            places = detailed
+        _write([p.to_row() for p in places], [p.to_dict() for p in places], PLACE_FIELDS, args.format, args.output)
+        count = len(places)
+    elif args.command == "place":
+        if not args.place_ids and not args.cid:
+            print("Pass at least one place_id or --cid.", file=sys.stderr)
+            return 2
+        places = []
+        for pid in args.place_ids:
+            try:
+                places.append(maps.place(place_id=pid))
+            except (ScrapeError, ValueError) as exc:
+                failures += 1
+                print(f"fail  {pid}: {exc}", file=sys.stderr)
+        for cid in args.cid:
+            try:
+                places.append(maps.place(data_cid=cid))
+            except (ScrapeError, ValueError) as exc:
+                failures += 1
+                print(f"fail  cid {cid}: {exc}", file=sys.stderr)
+        _write([p.to_row() for p in places], [p.to_dict() for p in places], PLACE_FIELDS, args.format, args.output)
+        count = len(places)
+    else:
+        try:
+            found = maps.reviews(
+                data_id=args.data_id or "", place_id=args.place_id or "", sort_by=args.sort, pages=args.pages, query=args.query
+            )
+        except (ScrapeError, ValueError) as exc:
+            print(f"fail  reviews: {exc}", file=sys.stderr)
+            return 1
+        _write([r.to_row() for r in found], [r.to_dict() for r in found], REVIEW_FIELDS, args.format, args.output)
+        count = len(found)
+
+    print(f"{count} record(s), {maps.credits_used} credits used" + (f", saved to {args.output}" if args.output else ""), file=sys.stderr)
+    return 1 if failures and not count else 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())