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.0When 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.
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 } }'
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
querystringrequiredcountry (default us) and written in language (default en): set them for a search elsewhere.nearobjectzoomintegerDefault 14near, 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 encountrystringDefault uspageintegerDefault 1next 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.cursorstringnext 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).
objectstringidstringpositionintegernamestringcategorieslistprimary_category_idstringresult_typestringaddress.fullstringaddress.streetstringaddress.neighborhoodstringaddress.citystringaddress.postal_codestringaddress.statestringaddress.country_codestringlocation.latitudefloatlocation.longitudefloatphonestringwebsite_urlstringrating.valuefloatrating.scalefloatrating.countintegerrating.distribution.1integerrating.distribution.2integerrating.distribution.3integerrating.distribution.4integerrating.distribution.5integerreview_topicslistdescriptionstringowner_descriptionstringbooking_urlstringhourslisttimezone). 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_hourslistlanguage.timezonestringattributeslistid is Google's own, the same in every language; value is true when the place has it.highlightslistid is the same in every language.actionslisturl is Google's own page for it; providers are the services it sends to (OpenTable, a delivery service, the place's site).owner.idstringowner.namestringpopular_times.weeklistpopular_times.live.hourintegerpopular_times.live.busynessintegerpopular_times.live.labelstringadmission.price.amountfloatadmission.price.currencystringadmission.price.textstringadmission.urlstringadmission.domainstringadmission.offerslisthotel.check_instringhotel.check_outstringhotel.price.amountfloathotel.price.currencystringhotel.price.textstringhotel.similarlistthings_to_dolistids.place_idstringids.cidstringids.feature_idstringids.kgmidstringphoto_urlstringurlstringsource_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
site_unavailable | 503 | Google Maps did not answer in time or refused the call; retry later (not charged). Retryable. |
unexpected_answer | 424 | Google 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-13next 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-271.1.02026-10-271.0.02026-10-26