Catalog / Search, maps & leads
SEARCH, MAPS & LEADS
Google Maps Places
Collect places from Google Maps searches: name, rating, review count, address, categories, coordinates, website, phone, opening hours and Maps link, one row per place.
About this data
Collect places from Google Maps searches: name, rating, review count, address, categories, coordinates, website, phone, opening hours and Maps link, one row per place. Search by term and location or paste a Maps search link. Failed searches are reported, not charged.
From the actor’s Apify Store listing. The per-call endpoint may return a bounded subset; its own description is below.
Buy per call over x402
One endpoint at api.ssh.autos. Each call is one JSON POST, paid in USDC with no account or API key, and answered in the same HTTP response.
POST /v1/google/maps/places
Return up to three places from the first result page of one Google Maps search: place identifiers, business name, category, address, coordinates, rating, review count, website, opening hours, image and Maps URL where published.
No individual reviews, reviewers or personal profiles.
One search-page request and one result-list request, without detail expansion.
Input
Send a JSON body to POST https://api.ssh.autos/v1/google/maps/places.
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | required | 3–200 characters |
countryCode | string | optional | pattern ^[a-z]{2}$; default "us" |
language | string | optional | pattern ^[a-z]{2,3}(-[A-Za-z]{2,4})?$; default "en" |
maxResults | integer | optional | 1–3; default 3 |
Returned fields
The answer is JSON: records, a list of up to 3, and summary, the run status and counts. Each record has these 32 fields; a field the source does not publish comes back null.
32 fields per record
| Field | Type | Notes |
|---|---|---|
kind | string | Every default-dataset row is a place row. Failed searches live in OUTPUT.searchErrors and are not dataset rows or billed. one of place |
placeId | string | Google place ID (ChIJ...). |
cid | string | Google customer ID (decimal), as used in maps.google.com/?cid= links. |
featureId | string | Google Maps feature ID (0x...:0x...). |
name | string | — |
rating | number | — |
reviewCount | integer | — |
priceLevel | string | Price level or range as Google shows it (for example $$ or $10–20), when present. |
categories | array of strings | — |
primaryCategory | string | — |
address | string | Full formatted address. |
street | string | — |
neighborhood | string | — |
city | string | — |
postalCode | string | — |
state | string | — |
countryCode | string | Two-letter country code of the place. |
latitude | number | — |
longitude | number | — |
distanceMeters | number | Haversine distance from the requested centre in metres, rounded to 3 decimals. Present only in radius mode; all returned places are within radiusMeters. |
timezone | string | — |
website | string | — |
phone | string | Phone number in local format. |
phoneInternational | string | Phone number in international E.164 format. |
openingHours | array of objects | One entry per weekday, as Google shows it for the current week. |
imageUrl | string | Main photo thumbnail. |
mapsUrl | string | Link that opens this place on Google Maps. |
searchQuery | string | The search term this row came from (null for a pasted search link). |
searchUrl | string | The Google Maps search the row came from. |
rank | integer | Position of the place in its search results. |
scrapedAt | string | — |
error | object | Always null in the default dataset. Failed searches live in OUTPUT.searchErrors and are not dataset rows or billed. |
Example call
npx agentcash@latest fetch https://api.ssh.autos/v1/google/maps/places -m POST -b '{"query": "coffee shops in Manhattan", "maxResults": 2}'The example values come from the API spec or the actor’s own sample input. Running it is a paid call.
What is and isn’t charged
You pay the call price for
- An answer, including a definitive “not found” or an empty result.
- Confirmed no matches returns records: [] (charged: it is an answer).
Free
- Invalid input (422), busy (503), source failure (502), timeout (504) and calls whose client hung up are never charged.
- Invalid input and source failures are not charged.
Prefer a subscription? Run it on Apify
This data source is a public actor on the Apify Store: Google Maps Places Scraper. Run it with your Apify account and plan for larger, scheduled or exported runs; it may offer more input options than the per-call endpoint.
How x402 payment works
- Your client sends the request. The API answers
402 Payment Requiredwith the price and where to pay. - The client pays from its own wallet: USDC on Base or Solana over x402, or over MPP on Tempo. No account, sign-up or API key.
- The client retries with the payment attached and gets the JSON answer in the same call. You are only charged for answers.
The AgentCash CLI in the example does all three steps for you and pays from your AgentCash wallet. Any x402 or MPP client works the same way.
Machine-readable: openapi.json · llms.txt