GmapsLeadFinder.GoogleMapsScraper.Cli 0.1.1

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet tool install --global GmapsLeadFinder.GoogleMapsScraper.Cli --version 0.1.1
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local GmapsLeadFinder.GoogleMapsScraper.Cli --version 0.1.1
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=GmapsLeadFinder.GoogleMapsScraper.Cli&version=0.1.1
                    


                    

                
nuke :add-package GmapsLeadFinder.GoogleMapsScraper.Cli --version 0.1.1

Google Maps Scraper

<p align="center"> <img src="https://raw.githubusercontent.com/google-maps-lead-scraper/google-maps-scraper/main/google-maps-scraper.png" alt="Google Maps Lead Scraper" width="100%" /> </p>

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

.NET SDK to scrape Google Maps places and export leads (name, phone, website, emails, and more) 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

dotnet add package GmapsLeadFinder.GoogleMapsScraper
dotnet tool install -g GmapsLeadFinder.GoogleMapsScraper.Cli

Requires .NET 8.0+. No third-party HTTP dependencies (HttpClient + System.Text.Json).

Quickstart

using GmapsLeadFinder.GoogleMapsScraper;

using var client = new Client(); // reads GMF_API_KEY
var me = await client.MeAsync();
Console.WriteLine($"{me.GetProperty("plan")} {me.GetProperty("creditsRemaining")}");

var rows = await client.ScrapeAsync("dentists in Austin TX");
Console.WriteLine(rows.Count);

CLI:

gmaps-scraper me
gmaps-scraper scrape "dentists in Austin TX" --out leads.json

From this directory:

dotnet run --project examples/Quickstart
dotnet run --project src/GmapsLeadFinder.GoogleMapsScraper.Cli -- me

Client API

Method Description
new Client(options?) From env / ApiKey / BaseUrl / Timeout
MeAsync() Plan & credits (JsonElement)
CreateJobAsync(keyword) Queue one-keyword job
GetJobAsync(jobId) Poll status
GetResultsAsync(jobId, options?) Paginated rows (Limit, Cursor)
ScrapeAsync(keyword, options?) Create → poll → all rows

ScrapeOptions: PollIntervalMs (2000), TimeoutMs (600000), ResultLimit (100).

Errors

HTTP Class
400 BadRequestException
401 AuthenticationException
402 InsufficientCreditsException
403 PlanNotAllowedException
404 NotFoundException
409 JobConflictException
— TimeoutException, ApiException

All under GmapsLeadFinder.GoogleMapsScraper.Exceptions.

Limits

  • Exactly one keyword per API job
  • One running job per user (409 if busy)
  • 1 credit = 1 place row; Growth+ required

Publish to NuGet

cd dotnet
dotnet pack src/GmapsLeadFinder.GoogleMapsScraper -c Release
dotnet pack src/GmapsLeadFinder.GoogleMapsScraper.Cli -c Release
dotnet nuget push src/GmapsLeadFinder.GoogleMapsScraper/bin/Release/*.nupkg \
  --api-key $NUGET_API_KEY --source https://api.nuget.org/v3/index.json
dotnet nuget push src/GmapsLeadFinder.GoogleMapsScraper.Cli/bin/Release/*.nupkg \
  --api-key $NUGET_API_KEY --source https://api.nuget.org/v3/index.json
Resource URL
Website https://gmapsleadfinder.com
HTTP API https://gmapsleadfinder.com/docs/api
NuGet https://www.nuget.org/packages/GmapsLeadFinder.GoogleMapsScraper
Monorepo https://github.com/google-maps-lead-scraper/google-maps-scraper

License

MIT

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.1.1 36 9/16/2026