{"uid":"cap_cfqOG0u6SbNBojtRFx7D7","slug":"onhub-places-search-e401755b","name":"OnHub Places Search","description":"Grounded local search over Google Maps places with ratings, address and hours.","url":"https://api.onhub.ai/v1/places?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","maxLength":2000,"minLength":3,"description":"A local/places question to research with Google Maps grounding, e.g. \"best ramen near the ferry building\"."},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"Caller latitude. Improves relevance for \"near me\"-style queries; omit for non-local questions."},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"Caller longitude. Must be supplied together with latitude."},"max_results":{"type":"integer","default":5,"maximum":8,"minimum":1}}},"responseSchema":{"type":"json","example":{"query":"Best Italian restaurants within walking distance","answer":"Maccheroni Republic (4.6★) is a short walk away.","object":"places.result","places":[{"url":"https://maps.google.com/?cid=10713702449749472098","title":"Maccheroni Republic","place_id":"ChIJvVvovUvGwoARYrOMSp23rpQ"}],"searched_at":"2026-09-22T00:00:00.000Z","evidence_status":"grounded"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SBe9Hby-SEz8ZfQsB6Etj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs grounded local place search using Google Maps data, returning rated businesses with addresses, hours, and map links.","exampleAgentPrompt":"Find me the top 5 best-rated ramen spots near the Ferry Building in San Francisco — I'm at 37.7955, -122.3937 — with their ratings and hours.","exampleUseCases":[{"title":"Dinner spot near current location","prompt":"I'm at latitude 40.7580, longitude -73.9855 in Midtown Manhattan — can you find me the top 3 highest-rated Italian restaurants within walking distance, with their hours and ratings?"},{"title":"Errand planning around a neighborhood","prompt":"I need to find a highly rated dry cleaner near Dupont Circle in DC — I'm at 38.9096, -77.0434 — can you pull up the best options with their hours and addresses?"},{"title":"Traveler finding local attractions","prompt":"I'm visiting Austin, Texas and I'm at 30.2672, -97.7431 — what are the top 5 best-rated live music venues or bars nearby? Give me their ratings and Google Maps links."}],"resultDescription":"Returns a natural language answer grounded in Google Maps data, plus a list of matching places each with a name, star rating, Google Maps URL, and place ID. Also includes the timestamp of the search and an evidence_status field confirming the result is grounded.","failureModes":["Query too vague or non-local returns low-relevance or empty places list","Missing longitude when latitude is provided (or vice versa) may degrade location relevance","Query string under 3 characters is rejected by schema validation","max_results exceeding 8 is rejected","No matching places found for the query in the specified area returns empty places array","Payment failure or insufficient USDC balance results in 402 response"],"whenToPreferThis":"Choose this endpoint when you need real-world, grounded place data from Google Maps with star ratings, hours, and verifiable map links — especially for 'near me' or location-specific queries. Prefer this over generic web search when the user is looking for a specific type of business or service at a known location and needs structured place metadata (ratings, hours, URLs) rather than editorial articles or reviews.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:35:09.678Z","isFirstParty":false,"canonicalSlug":"onhub-places-search-e401755b"}