Create Google Maps scraper runs, retrieve places, enrich websites, export CSV, and import results into lead lists

Google Maps Scraper

The Google Maps Scraper API lets you call Hermes directly to discover local businesses from Google Maps search results.

Hermes creates an asynchronous run, scrapes matching places, stores normalized place data, optionally enriches business websites for contacts, and can import qualified results into a Hermes lead list.

Base Path

/v1/google-maps-scraper

All endpoints require the normal Hermes Bearer token:

Authorization: Bearer hermes_your_api_key

Run Lifecycle

Create a run with search terms and location.
Poll the run until status is completed, failed, or cancelled.
Read normalized items or export CSV.
Optionally run website enrichment.
Import enriched contacts or phone-only business contacts into a lead list.

Statuses

Status	Description
`queued`	Run was accepted and queued
`running`	Google Maps discovery is in progress
`enriching`	Website contact enrichment is in progress
`completed`	Run finished successfully
`failed`	Run could not complete
`cancelled`	Run was cancelled

Supported Inputs

Field	Type	Description
`searchStringsArray`	`string[]`	Keyword searches such as `["coffee shop", "dentist"]`
`locationQuery`	`string`	Location text such as `Lagos Nigeria` or `Austin TX`
`countryCode`	`string`	Two-letter country code used for Maps targeting
`language`	`string`	UI/search language, default `en`
`maxCrawledPlacesPerSearch`	`number`	Maximum places to save per search
`website`	`string`	`allPlaces`, `withWebsite`, or `withoutWebsite`
`placeMinimumStars`	`number`	Minimum rating filter
`skipClosedPlaces`	`boolean`	Skip permanently or temporarily closed places
`categoryFilterWords`	`string[]`	Keep places whose category matches these words
`startUrls`	`string[]`	Direct Google Maps place URLs
`placeIds`	`string[]`	Direct Google place IDs
`scrapeContacts`	`boolean`	Enrich websites automatically after scraping
`verifyEmails`	`boolean`	Verify extracted emails during enrichment
`leadListId`	`number`	Optional lead list to associate with the run

Normalized Item Fields

Each run item can include:

title
placeId
mapsUrl
address
lat, lng
categoryName, categories
rating, reviewsCount
phone
website
emails
socialProfiles
contactPages
emailValidation
searchString, locationQuery, rank
sourceProvider, scrapedAt

Google Maps Scraper

Google Maps Scraper

Base Path

Run Lifecycle

Statuses

Supported Inputs

Normalized Item Fields

Pages

On this page