{"uid":"cap_rwYnPgEuYd_J7d5LCuCqQ","slug":"api-direct-google-maps-places-search-576780e7","name":"API Direct – Google Maps Places Search","description":"Search Google Maps places (local businesses, restaurants, hotels, shops and points of interest) by free-text query.","url":"https://x402.apidirect.io/v1/places/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"lat":{"type":"number","description":"Center latitude for geographic bias (provide with `lng`)"},"lng":{"type":"number","description":"Center longitude for geographic bias (provide with `lat`)"},"zoom":{"type":"integer","maximum":20,"minimum":1,"description":"Map zoom level. Smaller values widen the search radius (13 ≈ city, 15 ≈ neighborhood, 10 ≈ metro area)"},"limit":{"type":"integer","maximum":200,"minimum":1,"description":"Alternative to `pages`: maximum number of results, rounded up to whole pages of 10 (e.g. `limit=15` fetches 2 pages, so up to 20 results). Ignored when `pages` is also sent. Maximum 200"},"pages":{"type":"integer","default":1,"maximum":20,"minimum":1,"description":"Number of pages to fetch and merge. Each page returns up to 10 results and is billed as one request"},"query":{"type":"string","maxLength":500,"description":"Search keyword (max 500 characters). E.g. `coffee shops brooklyn`, `dentists 90210`, `hilton hotels paris`"},"country":{"type":"string","default":"us","maxLength":2,"minLength":2,"description":"2-letter ISO 3166-1 alpha-2 region code"},"language":{"type":"string","default":"en","maxLength":2,"minLength":2,"description":"2-letter ISO 639-1 language code"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.011","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.011/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.011","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SV849ONf0j65mJYjpvCsf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.011","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Google Maps for local businesses, restaurants, hotels, shops, and points of interest by free-text query with optional geographic bias.","exampleAgentPrompt":"Can you find me Italian restaurants in Brooklyn, New York? Search around latitude 40.6782, longitude -73.9442 at a neighborhood zoom level and return up to 20 results.","exampleUseCases":[{"title":"Restaurant discovery for travel planning","prompt":"I'm visiting Paris next month — can you search for the top rooftop bars in Paris, France using Google Maps places? Give me up to 20 results in French."},{"title":"Local service provider lookup","prompt":"Find dentists near downtown Austin, Texas — search around lat 30.2672, lng -97.7431 at city zoom level and give me the first page of results."},{"title":"Hotel search for a specific destination","prompt":"Search Google Maps for Hilton hotels in Tokyo, Japan — use country code JP and language ja, and return up to 10 results."}],"resultDescription":"A merged list of place results (up to 200) from Google Maps, each typically including business name, address, geographic coordinates, place category, rating, and other available metadata. Results are paginated internally and merged based on the pages or limit parameter.","failureModes":["Missing required 'query' parameter returns a 400 validation error","Invalid country or language code may return empty results or an error","Providing lat/lng without both values may result in no geographic bias being applied","Requesting more than 20 pages or 200 results exceeds limits and may be clamped or rejected","Overly broad queries may return noisy, irrelevant results","No results found for very specific or obscure queries in certain regions"],"whenToPreferThis":"Choose this endpoint when you need free-text search across Google Maps places data — local businesses, restaurants, hotels, or POIs — especially when you want geographic bias via lat/lng and zoom. Prefer it over general web search when structured place data (addresses, ratings, coordinates) is needed rather than unstructured text results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:05.345Z","isFirstParty":false,"canonicalSlug":"api-direct-google-maps-places-search-576780e7"}