Skip to content
Google Maps

Search places

One page of places for a Google Maps search, 20 at most, as the results list shows them.

google_maps/places/search20 credits a callv1.3.0

When to use it

You need the places Google Maps lists for a search such as "dentist" near a point or "restaurants in Lyon": name, categories, address, coordinates, phone, website, rating, opening hours. For one place's full profile, use google_maps/places/get; for its reviews, google_maps/reviews/list.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
What you would type in Google Maps' search box: a kind of place ("dentist"), a name, or both with a place ("restaurants in Lyon").
Optional: the point to search around, as the map would centre on it ("bakery" around a spot).
The map's zoom around near, from 3 (a continent) to 20 (a street).
The language of names, categories and hours, as an ISO 639-1 code.
The country Google ranks results for, as an ISO 3166-1 alpha-2 code in lower case.
The page to start at; next in an answer goes on from it with cursor.
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor).
20 credits a call
Code, from the fields above
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "google_maps",
    "operation": "places/search",
    "options": {
      "query": "restaurants in Lyon",
      "page": 1
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_s5marqhincfykpisq3artgziza",
  "livemode": true,
  "source": "google_maps",
  "operation": "places/search",
  "version": "1.3.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/google_maps/places/search",
  "options": {
    "query": "restaurants in Lyon",
    "page": 1
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": true,
  "next": {
    "source": "google_maps",
    "operation": "places/search",
    "options": {
      "query": "restaurants in Lyon",
      "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5"
    }
  },
  "cost": {
    "credits": 20
  },
  "results": [
    {
      "object": "place",
      "id": "ChIJAAAAAAAAAAAAAAAAAAAAAAA",
      "position": 1,
      "name": "Acme Bistro",
      "categories": [
        "French restaurant"
      ],
      "primary_category_id": null,
      "result_type": "french_restaurant",
      "address": {
        "full": "1 Rue Exemple, 69005 Lyon, France",
        "street": "1 Rue Exemple",
        "neighborhood": null,
        "city": "Lyon",
        "postal_code": "69005",
        "state": null,
        "country_code": "FR"
      },
      "location": {
        "latitude": 45.7623,
        "longitude": 4.8275
      },
      "phone": "+33400000000",
      "website_url": "https://acme-bistro.example",
      "rating": {
        "value": 4.5,
        "scale": 5,
        "count": 1280,
        "distribution": null
      },
      "review_topics": null,
      "description": "Local food and wine in vintage surrounds",
      "owner_description": null,
      "booking_url": "https://acme-bistro.example/booking",
      "hours": [
        {
          "day": "monday",
          "intervals": [
            {
              "open": "11:30",
              "close": "14:30"
            },
            {
              "open": "18:30",
              "close": "22:00"
            }
          ]
        },
        {
          "day": "tuesday",
          "intervals": []
        }
      ],
      "more_hours": [
        {
          "label": "Kitchen",
          "hours": [
            {
              "day": "monday",
              "intervals": [
                {
                  "open": "12:00",
                  "close": "14:00"
                }
              ]
            }
          ]
        }
      ],
      "timezone": "Europe/Paris",
      "attributes": [
        {
          "id": "has_wheelchair_accessible_entrance",
          "label": "Wheelchair-accessible entrance",
          "group": "accessibility",
          "value": true
        }
      ],
      "highlights": [
        {
          "id": "lgbtq_friendly",
          "label": "LGBTQ+ friendly"
        }
      ],
      "actions": [
        {
          "type": "reserve",
          "label": "Reserve a table",
          "url": "https://www.google.com/maps/reserve/v/dine/c/AAAAAAAAAAA?source=pa&hl=en",
          "providers": [
            {
              "name": "Acme Bookings",
              "domain": "acme-bookings.example",
              "url": "https://acme-bookings.example/r/1"
            }
          ]
        }
      ],
      "owner": {
        "id": "100000000000000000000",
        "name": "Acme Bistro (Owner)"
      },
      "popular_times": {
        "week": [
          {
            "day": "monday",
            "hours": [
              {
                "hour": 12,
                "busyness": 45
              },
              {
                "hour": 13,
                "busyness": 80
              }
            ]
          }
        ],
        "live": {
          "hour": 13,
          "busyness": 60,
          "label": "Usually not too busy"
        }
      },
      "admission": null,
      "hotel": null,
      "things_to_do": [],
      "ids": {
        "place_id": "ChIJAAAAAAAAAAAAAAAAAAAAAAA",
        "cid": "1000000000000000000",
        "feature_id": "0x47f4000000000000:0x0de0b6b3a7640000",
        "kgmid": "/g/11aaaaaaaa"
      },
      "photo_url": "https://lh3.googleusercontent.com/example.jpg",
      "url": "https://www.google.com/maps/search/?api=1&query=45.7623%2C4.8275&query_place_id=ChIJAAAAAAAAAAAAAAAAAAAAAAA",
      "source_url": "https://www.google.com/maps/search/restaurants+in+Lyon",
      "observed_at": "2026-10-26T09:00:00Z"
    }
  ]
}

Options

querystringrequired
What you would type in Google Maps' search box: a kind of place ("dentist"), a name, or both with a place ("restaurants in Lyon"). Results are ranked for country (default us) and written in language (default en): set them for a search elsewhere.
nearobject
Optional: the point to search around, as the map would centre on it ("bakery" around a spot). Leave it out when the query names its place ("restaurants in Lyon", "Le Vieux Lyon, Lyon"): Google locates it, better than a guessed point. Left out with a query naming no place, Google uses the country.
zoomintegerDefault 14
The map's zoom around near, from 3 (a continent) to 20 (a street). Google lists places from the whole area the map shows, ranked by relevance, not by distance: at 13 they spread about 4 km around near, at 15 about 1 km (a neighbourhood), at 17 a few hundred metres (a street). Used only with near.
languagestringDefault en
The language of names, categories and hours, as an ISO 639-1 code.
countrystringDefault us
The country Google ranks results for, as an ISO 3166-1 alpha-2 code in lower case.
pageintegerDefault 1
The page to start at; next in an answer goes on from it with cursor. Google Maps stops listing after 200 to 300 places, depending on the search: the last page is short, a page past the end is empty and free.
cursorstring
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor). Leave it out to start at page.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
The kind of record: a place, whichever site it comes from.
idstring
Google's place id (ChIJ...), stable across languages; repeated in ids.place_id.
positioninteger
Its rank among the places of the search, across pages: 21 is the first of page 2.
namestring
categorieslist
As Google Maps names them, the main one first.
primary_category_idstring
Null in a list of results: Google gives a place's category id only on its page (google_maps/places/get). result_type is the family a list does give.
result_typestring
Google's search-result type for the place, the same in every language: a family for most places (shopping, industrial, personal_care), finer for some (french_restaurant, bakery, park). Not its category: categories has those by name, and places/get gives primary_category_id.
address.fullstring
address.streetstring
address.neighborhoodstring
The district Google files the place under: Manhattan.
address.citystring
address.postal_codestring
address.statestring
The state or region, where the address has one: New York.
address.country_codestring
ISO 3166-1 alpha-2
location.latitudefloat
Degrees, 7 decimals (about a centimetre).
location.longitudefloat
Degrees, 7 decimals.
phonestring
E.164; null when Google gives no international number.
website_urlstring
rating.valuefloat
rating.scalefloat
The best possible value: ratings from other sites compare once divided by it.
rating.countinteger
rating.distribution.1integer
rating.distribution.2integer
rating.distribution.3integer
rating.distribution.4integer
rating.distribution.5integer
review_topicslist
The topics Google draws from the reviews (pleasant waiters), how many reviews mention each, and the id Google filters the reviews by; null when the answer has none (a list of results).
descriptionstring
Google's short summary of the place, when it has one.
owner_descriptionstring
What the place says of itself on its profile, as its owner wrote it (From the owner); null when it says nothing.
booking_urlstring
hourslist
The week, Monday first, in local time (timezone). A day closed has no interval; intervals: null is a day Google gives in a shape we cannot read (unknown, never closed); a close earlier than its open ends the next day; null when Google shows no hours.
more_hourslist
Hours of a service apart from the place's own (Kitchen, Brunch, Takeout...), labelled in language.
timezonestring
IANA time zone.
attributeslist
What Google lists about the place in its results (accessibility...). id is Google's own, the same in every language; value is true when the place has it.
highlightslist
Google's badges on the place: LGBTQ+ friendly, women-owned. id is the same in every language.
actionslist
What people can do from Google: reserve a table, order online. url is Google's own page for it; providers are the services it sends to (OpenTable, a delivery service, the place's site).
owner.idstring
owner.namestring
popular_times.weeklist
popular_times.live.hourinteger
popular_times.live.busynessinteger
popular_times.live.labelstring
admission.price.amountfloat
admission.price.currencystring
admission.price.textstring
admission.urlstring
admission.domainstring
admission.offerslist
hotel.check_instring
hotel.check_outstring
hotel.price.amountfloat
hotel.price.currencystring
hotel.price.textstring
hotel.similarlist
things_to_dolist
The tours and activities Google offers at the place: title, seller, price, duration, rating.
ids.place_idstring
ids.cidstring
Customer id: the second half of feature_id, in decimal; google.com/maps?cid= opens the place.
ids.feature_idstring
Feature id (0x...:0x...), what reviews and photos are listed by.
ids.kgmidstring
Knowledge Graph id (/g/...).
photo_urlstring
The place's main photo.
urlstring
The place on Google Maps (Maps URLs, query_place_id).
source_urlstring
The search these values were read from.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
site_unavailable503Google Maps did not answer in time or refused the call; retry later (not charged). Retryable.
unexpected_answer424Google Maps answered in a shape we do not read yet; we are told and fix it, and it is not charged. Retrying now gives the same.

Price

20 credits a call, whatever the page holds: a short last page costs a whole call. An empty page (past the end, or no results) and a failed call are free. What a credit costs on each plan: Credits and pricing.

Changelog

1.3.02026-11-13
next keeps the search as it was written and goes on with cursor, opaque, as every paged operation of the API (Google's page tokens): copy next as before. page still starts at any page.
1.2.02026-10-27
primary_category_id said it was the main category's id but held Google's search-result type, a family for most places (shopping for a sewing machine store). That value is now result_type. primary_category_id is the main category's real id, which only a place's page gives: places/get fills it, places/search leaves it null.
1.1.02026-10-27
Three fields Google gives on a place's page: rating.distribution (reviews per number of stars), review_topics (the topics drawn from the reviews, with their mentions) and owner_description (what the place says of itself). Found by the preventive loop (lobstrio/platform#19).
1.0.02026-10-26
First version on the API v2.