google-maps-scraper-sdk 0.1.3

Google Maps Scraper / Extractor / Lead Scraper SDK for the GMaps Lead Finder Agent HTTP API
Documentation

Google Maps Scraper

Google Maps Extractor · Google Maps Lead Scraper · Google Maps Lead Extractor

Rust SDK to scrape Google Maps places (leads), reviews, and photos through a hosted Agent HTTP API. Powered by GMaps Lead Finder. This is not a local browser crawler — jobs run in the cloud scrape-and-enrich pipeline.

Get an API key

  1. Sign in at gmapsleadfinder.com.
  2. Use a plan with Agent API (Growth or higher) — see Pricing.
  3. Open Account → API key and copy your gmf_… key.
export GMF_API_KEY=gmf_your_key_here

Install

cargo add google-maps-scraper-sdk
# or: cargo install google-maps-scraper-sdk --bin gmaps-scraper

Requires Rust 1.70+.

Quickstart

use google_maps_scraper_sdk::{Client, ClientOptions};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new(ClientOptions::default())?; // reads GMF_API_KEY
    let me = client.me()?;
    println!("{} {}", me.plan, me.credits_remaining);

    let rows = client.scrape("dentists in Austin TX", Default::default())?;
    println!("{} {:?}", rows.len(), rows.first());

    // Single-place reviews / photos (run sequentially — one in-flight job per user)
    let reviews = client.scrape_reviews("https://maps.google.com/?cid=…", Default::default())?;
    let photos = client.scrape_photos("ChIJ…", Default::default())?; // Place ID, URL, or business_id
    println!("{} {}", reviews.len(), photos.len());
    Ok(())
}

CLI:

cargo install google-maps-scraper-sdk --bin gmaps-scraper
gmaps-scraper me
gmaps-scraper scrape "dentists in Austin TX" --out leads.json

From this repo:

cd rust
cargo run --example quickstart
cargo run --bin gmaps-scraper -- me

Client API

Method Description
Client::new(opts) From env / options
me() Plan & credits
create_job(keyword) Queue one-keyword leads job
get_job(job_id) Poll leads status
get_results(job_id, opts) Paginated leads rows
scrape(keyword, opts) Create → poll → all leads rows
create_reviews_job(place) Queue single-place reviews job
get_reviews_job(job_id) Poll reviews status
get_reviews_results(job_id, opts) Paginated review rows
scrape_reviews(place, opts) Create → poll → all review rows
create_photos_job(place) Queue single-place photos job
get_photos_job(job_id) Poll photos status
get_photos_results(job_id, opts) Paginated photo rows
scrape_photos(place, opts) Create → poll → all photo rows

Errors

Error variants: Authentication (401), PlanNotAllowed (403), InsufficientCredits (402), JobConflict (409), NotFound (404), BadRequest (400), Timeout, Api, Http, Json.

Limits

  • Exactly one keyword per leads job; exactly one place per reviews or photos job
  • One running job per user (409 if busy); run keywords/places sequentially
  • 1 credit = 1 place row; Growth+ required

Publish to crates.io

cargo login
cd rust
cargo publish --dry-run
cargo publish

Links

Resource URL
Website https://gmapsleadfinder.com
HTTP API https://gmapsleadfinder.com/docs/api
crates.io https://crates.io/crates/google-maps-scraper-sdk
Source https://github.com/gmaps-lead-finder/google-maps-scraper

License

MIT