Search Google Maps the way its search box does, "coffee shops" in "Denver, CO" or around a point with a radius, and get each place with its IDs, category, address, coordinates, phone, website, rating and review count, opening hours, open-now status, business status and time zone. Filter by minimum rating, open now or category, and continue with nextCursor. Billing: each Google result page read counts as one request (pagesScraped). A search takes about 5 to 40 seconds.

POST /place-search Places

https://api.fetchlayer.dev/google-maps/place-search

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

query string required

What to search for, e.g. "coffee shops" or "dentist".

location string optional

Area to search in, as text: a city, neighborhood or address ("Austin, TX", "Shoreditch, London"). Use either location or coordinates.

coordinates object optional

Search around a point instead: { latitude, longitude, radiusMeters } with radiusMeters 100-50000 (default 5000).

language string optional

Language for place names, categories and hours, as a language code (en, de, pt-BR). (default: en)

country string optional

Two-letter country code the results are localized for (US, GB, DE). (default: US)

limit number optional

Maximum places to return, 1-100. (default: 20)

cursor string optional

nextCursor from a previous response, to continue the same search.

minRating number optional

Only places rated at least this (1-5).

openNow boolean optional

Only places open at the time of the request.

category string optional

Only places whose Google Maps category contains this text, e.g. "Italian restaurant" or "bakery".

Response Fields

place-search

Search Google Maps for places

entityType string

Always gmaps-place-search.

query string

The search that ran, with location, coordinates, language, country and filters echoed.

places object[]

The places, in Google Maps order.

places[].placeId string

Google place ID (ChIJ…), with featureId (0x…:0x…) and cid alongside it.

places[].name string

The place name, with category and categories.

places[].address string

The full address; addressComponents splits it into neighborhood, street, city, postalCode, state and countryCode.

places[].coordinates object

latitude and longitude.

places[].phone string | null

The phone number as Google shows it, with phoneInternational in E.164 form.

places[].website string | null

The website listed on the place.

places[].rating number | null

Average rating, with reviewCount alongside it.

places[].priceLevel string | null

Price level, only when Google shows one.

places[].openingHours object[]

Hours by day, each with day and hours[].

places[].openNow boolean | null

Whether it is open at the time of the request, with currentStatus as Google words it (e.g. "Open · Closes 5 PM").

places[].businessStatus string

OPERATIONAL, CLOSED_TEMPORARILY or CLOSED_PERMANENTLY.

places[].timezone string

IANA time zone, e.g. America/Denver.

places[].googleMapsUrl string

Link to the place on Google Maps, with thumbnailUrl for its photo.

placeCount number

Places in this response.

nextCursor string | null

Pass back as cursor to continue, or null when there are no more.

pagesScraped number

Google result pages read. Each counts as one request against your plan.

Request

curl -X POST "https://api.fetchlayer.dev/google-maps/place-search" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"coffee shops","location":"Denver, CO","limit":5}'

Response

{
  "entityType": "gmaps-place-search",
  "query": "coffee shops",
  "location": "Denver, CO",
  "coordinates": null,
  "language": "en",
  "country": "US",
  "filters": {},
  "placeCount": 5,
  "places": [
    {
      "placeId": "ChIJ4YBYuiB5bIcR4CF00Xm9cC0",
      "featureId": "0x876c7920ba5880e1:0x2d70bd79d17421e0",
      "cid": "3274325260001092064",
      "name": "Little Owl Coffee - Tremont",
      "category": "Cafe",
      "categories": [
        "Cafe"
      ],
      "address": "410 17th St, Denver, CO 80202",
      "addressComponents": {
        "neighborhood": "Central Business District",
        "street": "410 17th St",
        "city": "Denver",
        "postalCode": "80202",
        "state": "Colorado",
        "countryCode": "US"
      },
      "coordinates": {
        "latitude": 39.744006299999995,
        "longitude": -104.9889953
      },
      "plusCode": null,
      "phone": null,
      "phoneInternational": null,
      "website": "http://littleowlcoffee.com/",
      "rating": 4.6,
      "reviewCount": 168,
      "priceLevel": null,
      "openingHours": [
        {
          "day": "Monday",
          "hours": [
            "7 AM–5 PM"
          ]
        },
        {
          "day": "Tuesday",
          "hours": [
            "7 AM–5 PM"
          ]
        }
      ],
      "currentStatus": "Open · Closes 5 PM",
      "openNow": true,
      "businessStatus": "OPERATIONAL",
      "timezone": "America/Denver",
      "googleMapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJ4YBYuiB5bIcR4CF00Xm9cC0",
      "thumbnailUrl": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWmemx6efUuGv…"
    }
  ],
  "nextCursor": "eyJvIjowLCJzIjo1fQ",
  "pagesScraped": 1,
  "scrapedAt": "2026-09-15T21:17:18.537Z"
}

{
  "error": "Invalid API key"
}