{"uid":"cap_caW-e3H-LX4gK6BaqJDsL","slug":"agents-litescrape-com-search-google-maps-or-resolve-a-place-bc8dd116","name":"Search Google Maps or Resolve a Place","description":"Searches Google Maps or resolves one exact place. With type=search, q finds businesses, categories, or addresses inside a viewport given as ll (@lat,lon,14z or @lat,lon,5000m), a named location with z or m, or lat and lon with z or m, and returns local_results (position, title, rating, reviews, address, hours, place_id, data_id, and links to posts, photos, and web results) with pagination.next for the next page of 20. With type=place, or with place_id or data_cid, it returns one place_results entry. Filter by price level, min_rating, and opening state. One call is one request.","url":"https://agents.litescrape.com/api/google/maps","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"m":{"type":"number","maximum":15028132,"minimum":1,"description":"Search radius in meters for location or lat/lon geography. Cannot be combined with z."},"q":{"type":"string","description":"Business, category, address, or natural-language query. Required when type is search."},"z":{"type":"number","maximum":30,"minimum":3,"description":"Zoom level for location or lat/lon geography. Cannot be combined with m."},"gl":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"Two-letter country code for regional localization."},"hl":{"type":"string","default":"en","description":"Language for labels and returned text, such as en, es, or fr."},"ll":{"type":"string","description":"Viewport as @lat,lon,14z or @lat,lon,5000m."},"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Viewport center latitude. Requires lon and z or m."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Viewport center longitude. Requires lat and z or m."},"data":{"type":"string","maxLength":8192,"description":"Google Maps protobuf parameter sequence for search filters or an exact place. Exact-place data requires type=place."},"type":{"enum":["search","place"],"type":"string","description":"search for results, place for an exact-place data sequence. Required for query and filter searches."},"start":{"type":"integer","default":0,"minimum":0,"description":"Result offset. A Maps page holds 20 places; prefer pagination.next from the response."},"nearby":{"type":"boolean","default":false,"description":"Use the supplied geography as a nearby-search scope. Requires ll, location, or lat/lon."},"data_cid":{"type":"string","description":"Decimal Google CID to resolve one exact place. Cannot be combined with place_id or data."},"location":{"type":"string","description":"Named location resolved by the API. Requires z or m; cannot be combined with ll or lat/lon."},"place_id":{"type":"string","description":"Google place ID to resolve one exact place. Cannot be combined with data_cid or data."},"max_price":{"type":"integer","minimum":0,"description":"Maximum price level. Cannot be lower than min_price."},"min_price":{"type":"integer","minimum":0,"description":"Minimum price level. Cannot exceed max_price."},"min_rating":{"enum":[2,2.5,3,3.5,4,4.5],"type":"number","description":"Preferred minimum rating. Google treats it as a relevance preference."},"open_state":{"enum":["now","24h"],"type":"string","description":"Only places open now or open 24 hours. Cannot be combined with open_on_day or open_at_hour."},"open_on_day":{"enum":["mon","tue","wed","thu","fri","sat","sun"],"type":"string","description":"Only places open on this day."},"open_at_hour":{"type":"integer","maximum":23,"minimum":0,"description":"Only places open at this hour, 24-hour clock. Requires open_on_day."},"google_domain":{"type":"string","default":"google.com","description":"Google domain to query, such as google.com or google.co.uk."}}},"responseSchema":{"type":"object","properties":{"pagination":{"type":"object","description":"Present when more results exist: next (a ready-made URL for the next page) or next_page_token."},"local_results":{"type":"array","items":{"type":"object"},"description":"Places for a search: position, title, rating, reviews, address, place_id, data_id, and links to posts, photos, and web results."},"place_results":{"type":"array","items":{"type":"object"},"description":"The exact place for a place lookup."},"search_metadata":{"type":"object","properties":{"id":{"type":"string"},"status":{"type":"string"},"total_time_taken":{"type":"number"}}},"search_parameters":{"type":"object","description":"The request parameters as normalized by the API."},"search_information":{"type":"object","description":"For example local_results_state."}},"description":"Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000150","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.000150/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.000150","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KY_I-rgsCGu0krBFtWeAU","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000150","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.litescrape.com","brandSlug":"agents-litescrape-com-mpp","brandBaseUrl":"https://agents.litescrape.com","brandDocsUrl":null,"whatItDoes":"Searches Google Maps for local businesses, categories, or addresses within a viewport, or resolves a single exact place by ID, returning structured place data including ratings, hours, and reviews.","exampleAgentPrompt":"Search Google Maps for highly rated sushi restaurants (minimum 4 stars) near downtown San Francisco — use a 2000m radius and show results in English.","exampleUseCases":[{"title":"Find nearby open restaurants","prompt":"Find Italian restaurants open right now within 1 km of my location at latitude 40.7580, longitude -73.9855, and filter for places rated at least 4 stars."},{"title":"Resolve exact business details by place ID","prompt":"Look up the full Google Maps details for the place with ID ChIJN1t_tDeuEmsRUsoyG83frY4 — I need its address, hours, rating, and review count."},{"title":"Paginate through local business search","prompt":"Search Google Maps for 'urgent care clinic' in Boston using location name 'Boston, MA' with zoom level 13, then get me the next page of 20 results after the first batch."}],"resultDescription":"Returns a JSON object containing search_metadata (request ID, status, time taken), search_parameters (normalized inputs), and for search queries: local_results array with up to 20 places each having position, title, rating, reviews count, address, hours, place_id, data_id, and links to photos/posts/web results, plus a pagination.next URL for the next page. For place lookups: a place_results array with the single resolved place's full details.","failureModes":["Missing required parameter (q without type=search, or place lookup without place_id/data_cid/data) returns 400 with error and error_code","Invalid ll format or out-of-range lat/lon/z/m returns 400","Combining mutually exclusive parameters (z and m, or place_id and data_cid) returns 400","Place not found returns empty place_results or 404","Rate limit or payment failure returns 402 or 429 with retryable flag","Google Maps service unavailable returns 503 with retryable: true"],"whenToPreferThis":"Choose this endpoint when you need structured Google Maps search results or place details — especially when you need rating, review count, hours, price level, and place IDs in a single call. Prefer it over Bing Maps or Apple Maps endpoints when Google Maps data quality or Google-specific place IDs are required. Use the search type for discovery queries across categories and the place type for resolving a known place's full metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T17:29:16.834Z","isFirstParty":false}