Nearby & Bounding-Box Search

GET/v1/places/nearby5 Credits / place (min 10; 0 if empty)($0.0005 / place ($0.20–$0.50 / 1K places))

Discover Google Maps businesses inside a geographic viewport around exact GPS coordinates (lat, lng, zoom) or within an explicit bounding box (min_lat, min_lng, max_lat, max_lng). Ideal for grid-based territory scraping.

Parameters

qstringrequired
Category or keyword to search within the target coordinates (e.g., 'italian restaurant', 'HVAC contractor').
Example: italian restaurant
latnumber (-90 to 90)required
Center latitude coordinate (-90 to 90).
Example: 40.7233
lngnumber (-180 to 180)required
Center longitude coordinate (-180 to 180).
Example: -74.003
zoominteger (3 to 21)
Map viewport zoom level (3 to 21, default 15).
Example: 15
limitinteger (1 to 100)
Maximum number of businesses to return (1 to 100, default 20).
Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.googlemapsapi.io/v1/places/nearby?q=italian+restaurant&lat=40.7233&lng=-74.003" \
  -H "x-api-key: gm_live_your_api_key"

Live Response Preview

{
  "request_id": "req_gm_88412b9dc401",
  "status": "ok",
  "data": [
    {
      "place_id": "ChIJV2-tVGZZwokR9_3p246G5u8",
      "google_id": "0x89c2596654ad6f57:0xefe6868edb69fdf7",
      "cid": "17286646819044163063",
      "name": "Balthazar",
      "primary_category": "French restaurant",
      "categories": [
        "French restaurant",
        "Bistro",
        "Bakery"
      ],
      "rating": 4.4,
      "review_count": 5690,
      "price_level": "$$$",
      "phone": "+1 212-965-1414",
      "phone_e164": "+12129651414",
      "website": "https://balthazarny.com",
      "domain": "balthazarny.com",
      "address": {
        "formatted": "80 Spring St, New York, NY 10012",
        "street": "80 Spring St",
        "city": "New York",
        "state": "New York",
        "postal_code": "10012",
        "country_code": "US",
        "plus_code": "87G7PXXW+3V"
      },
      "coordinates": {
        "latitude": 40.722647,
        "longitude": -73.998229
      },
      "business_status": "OPERATIONAL",
      "is_claimed": true,
      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJV2-tVGZZwokR9_3p246G5u8"
    }
  ],
  "meta": {
    "credits_used": 10,
    "credits_remaining": 1980,
    "count": 1,
    "has_more": false,
    "next_cursor": null,
    "cache_hit": false
  }
}

Response Fields

Businesses discovered inside the target coordinate viewport.

Field	Type	Sample / Notes
`request_id`	string	Unique request trace identifier.
`status`	string	Response status ('ok').
`data`	array of PlaceSummary	Matching business profiles.
`place_id`	string	Unique Google Maps Place ID (ChIJ...).
`google_id`	string	Hexadecimal Google feature ID (0x...:0x...).
`cid`	string	Numeric Google Customer ID (CID).
`name`	string	Official business title on Google Maps.
`primary_category`	string	Primary business category.
`categories`	array of string	All assigned business categories.
`rating`	number	Aggregate star rating (1.0 to 5.0).
`review_count`	integer	Total number of Google Maps user reviews.
`price_level`	string	Price tier indicator ($ to $$$$).
`phone`	string	Formatted local phone number.
`phone_e164`	string	E.164 international phone number.
`website`	string	Official business website URL.
`domain`	string	Normalized root domain.
`address`	AddressObject
`formatted`	string	Full human-readable street address.
`street`	string	Street number and street name.
`city`	string	City or locality.
`state`	string	State, province, or region.
`postal_code`	string	ZIP or postal code.
`country_code`	string	ISO 3166-1 alpha-2 country code.
`plus_code`	string	Google Open Location Code (Plus Code).
`coordinates`	CoordinatesObject
`latitude`	number	WGS84 latitude coordinate.
`longitude`	number	WGS84 longitude coordinate.
`business_status`	string	OPERATIONAL, CLOSED_TEMPORARILY, or CLOSED_PERMANENTLY.
`is_claimed`	boolean	Whether the Google Business Profile is owner-verified.
`google_maps_url`	string	Direct link to the place on Google Maps.
`meta`	ResponseMeta
`credits_used`	integer	Credits deducted for this API call.
`credits_remaining`	integer	Remaining credit balance on the account.
`count`	integer	Number of records returned in data.
`has_more`	boolean	Whether additional pages are available.
`next_cursor`	string	Opaque cursor token for fetching the next page.
`cache_hit`	boolean	Whether the response was served from the sub-50ms local index.

Status Codes

200: Businesses discovered inside the target coordinate viewport.