Google Maps Text Search

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

Search Google Maps local businesses by natural-language query (e.g., 'coffee shops in SoHo, New York' or 'emergency plumbers in Austin, TX'). Returns structured business profiles including place_id, cid, phone number, website domain, rating, review count, opening hours, price level, and GPS coordinates.

Parameters

qstringrequired
Free-text search query including business category and location (e.g., 'coffee shops in SoHo, New York').
Example: coffee shops in SoHo, New York
latnumber (-90 to 90)
Optional latitude coordinate to bias search results (-90 to 90).
Example: 40.7233
lngnumber (-180 to 180)
Optional longitude coordinate to bias search results (-180 to 180).
Example: -74.003
zoominteger (3 to 21)
Map viewport zoom level (3 to 21, default 14).
Example: 14
limitinteger (1 to 100)
Maximum number of businesses to return (1 to 100, default 20).
Example: 20
regionstring
ISO 3166-1 alpha-2 country code (e.g., 'us', 'gb', 'de').
Example: us
languagestring
ISO 639-1 language code for localized names and categories (default 'en').
Example: en
freshboolean
Bypass the 30-day PostgreSQL index cache and force a live upstream Google Maps SERP fetch.
Example: false

Example Request (cURL / Python / JavaScript)

curl "https://api.googlemapsapi.io/v1/places/search?q=coffee+shops+in+SoHo%2C+New+York" \
  -H "x-api-key: gm_live_your_api_key"

Live Response Preview

{
  "request_id": "req_gm_99281a7bc102",
  "status": "ok",
  "data": [
    {
      "place_id": "ChIJN5X_gWdZwokRck9rk2guJ1M",
      "google_id": "0x89c2596781ff9537:0x53272e68936b4f72",
      "cid": "5991807586670235506",
      "name": "Felix Roasting Co.",
      "primary_category": "Coffee shop",
      "categories": [
        "Coffee shop",
        "Cafe",
        "Espresso bar"
      ],
      "rating": 4.5,
      "review_count": 782,
      "price_level": "$$",
      "phone": "+1 212-359-1139",
      "phone_e164": "+12123591139",
      "website": "https://felixroastingco.com",
      "domain": "felixroastingco.com",
      "address": {
        "formatted": "450 Broome St, New York, NY 10013",
        "street": "450 Broome St",
        "city": "New York",
        "state": "New York",
        "postal_code": "10013",
        "country_code": "US",
        "plus_code": "87G7PXXW+8Q"
      },
      "coordinates": {
        "latitude": 40.722341,
        "longitude": -74.001298
      },
      "business_status": "OPERATIONAL",
      "is_claimed": true,
      "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJN5X_gWdZwokRck9rk2guJ1M"
    }
  ],
  "meta": {
    "credits_used": 10,
    "credits_remaining": 1990,
    "count": 1,
    "has_more": false,
    "next_cursor": null,
    "cache_hit": false
  }
}

Response Fields

Paginated list of matching Google Maps business profiles.

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: Paginated list of matching Google Maps business profiles.