docs / google-maps

Google Maps

Places, business details, ratings and reviews.

base /google-maps/v13 endpoints

post/google-maps/v1/place/search2 credits

Search places by text query with optional lat/lng geo-bias. Returns up to 200 places with name, address, rating, categories, phone, website, coordinates.

Parameter		Allowed / range	Description
query	required	—	What to look for — business name, type or free text, ideally with a place hint ('pizza Brooklyn', 'Katz's Delicatessen Manhattan').
lat	optional	-90–90	Latitude to bias the search around. Strongly recommended — without it Google assumes the central US.
lng	optional	-180–180	Longitude to bias the search around (pair with lat).
maxResults = 20	optional	1–200	How many places to return (1–200). The engine pages Google's 20-per-page results internally — no page/cursor needed.
lang = en	optional	—	Result language (Google hl code: en, de, tr, es…). Affects category names and localized fields.
region = us	optional	—	Region bias (Google gl country code: us, de, tr…).
altitude = 15000	optional	100–10000000	Advanced: viewport altitude in meters — smaller = tighter local results, larger = wider area.

Try in playground →

post/google-maps/v1/place/detail3 credits

The single richest matching place: name, address, phone, website, rating, categories, coordinates, opening hours.

Parameter		Allowed / range	Description
query	required	—	The business to look up — name plus a location hint gives the best match.
lat	optional	-90–90	Latitude to bias the search around. Strongly recommended — without it Google assumes the central US.
lng	optional	-180–180	Longitude to bias the search around (pair with lat).
lang = en	optional	—	Result language (Google hl code: en, de, tr, es…). Affects category names and localized fields.
region = us	optional	—	Region bias (Google gl country code: us, de, tr…).

Try in playground →

post/google-maps/v1/place/freshness2 credits

Monitor a place for changes: returns the current place plus a typed diff vs the snapshot you pass from a previous call (hours/phone/website/rating changes).

Parameter		Allowed / range	Description
query	required	—	The business to monitor (same query each run).
lat	optional	-90–90	Latitude to bias the search around. Strongly recommended — without it Google assumes the central US.
lng	optional	-180–180	Longitude to bias the search around (pair with lat).
previous	optional	—	The `place` object from your previous freshness call. Omit on the first run (returns first_seen: true); pass it on later runs to get the change diff.
lang = en	optional	—	Result language (Google hl code: en, de, tr, es…). Affects category names and localized fields.
region = us	optional	—	Region bias (Google gl country code: us, de, tr…).

Try in playground →

Example request · place/search

curl -X POST https://api.reefapi.com/google-maps/v1/place/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"specialty coffee Times Square","lat":40.7589,"lng":-73.9881,"maxResults":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}