{"uid":"cap_Cz-is2HAVOLkDhI_LG3_-","slug":"stableenrich-partial-7e15db87","name":"Google Maps Nearby Search (Partial) via StableEnrich","description":"Google Maps Nearby Search (Partial). Finds places near a latitude/longitude using Google Places supported type filters. Use google-maps/text-search/partial for natural-language searches like \"wedding planner\" or \"event planner\".","url":"https://stableenrich.dev/api/google-maps/nearby-search/partial?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"languageCode":{"type":"string","default":"en"},"excludeFields":{"type":"array","items":{"type":"string"},"default":["photos"]},"excludedTypes":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Optional Google Places Table A place types to exclude."},"includedTypes":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"Optional Google Places Table A place types only, e.g. restaurant, bar, store, real_estate_agency. Do not use natural-language categories like wedding_planner or event_planner; use google-maps/text-search/full for text queries."},"maxResultCount":{"type":"number","default":5,"maximum":5,"minimum":1},"rankPreference":{"enum":["POPULARITY","DISTANCE"],"type":"string","default":"POPULARITY"},"locationRestriction":{"type":"object","required":["circle"],"properties":{"circle":{"type":"object","required":["center","radius"],"properties":{"center":{"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"description":"Latitude/longitude center point for the nearby search circle.","additionalProperties":false},"radius":{"type":"number","maximum":50000,"minimum":0,"description":"Radius in meters. Google Places caps this at 50000."}},"additionalProperties":false}},"description":"Required search area. Use locationRestriction.circle.center and locationRestriction.circle.radius; do not send top-level center or radius fields.","additionalProperties":false}}},"responseSchema":{"type":"object","properties":{"places":{"type":"array","items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"dineIn":{"type":"boolean"},"photos":{"type":"array","items":{"type":"object","required":["name","widthPx","heightPx"],"properties":{"name":{"type":"string"},"widthPx":{"type":"number"},"heightPx":{"type":"number"}},"additionalProperties":false}},"rating":{"type":"number"},"reviews":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"text":{"type":"object","required":["text","languageCode"],"properties":{"text":{"type":"string"},"languageCode":{"type":"string"}},"additionalProperties":false},"rating":{"type":"number"},"publishTime":{"type":"string"},"originalText":{"type":"object","required":["text","languageCode"],"properties":{"text":{"type":"string"},"languageCode":{"type":"string"}},"additionalProperties":false},"authorAttribution":{"type":"object","required":["displayName"],"properties":{"uri":{"type":"string"},"photoUri":{"type":"string"},"displayName":{"type":"string"}},"additionalProperties":false},"relativePublishTimeDescription":{"type":"string"}},"additionalProperties":false}},"takeout":{"type":"boolean"},"delivery":{"type":"boolean"},"location":{"type":"object","required":["latitude","longitude"],"properties":{"latitude":{"type":"number"},"longitude":{"type":"number"}},"additionalProperties":false},"restroom":{"type":"boolean"},"liveMusic":{"type":"boolean"},"allowsDogs":{"type":"boolean"},"priceLevel":{"type":"string"},"priceRange":{"type":"object","properties":{"endPrice":{"type":"object","required":["currencyCode","units"],"properties":{"units":{"type":"string"},"currencyCode":{"type":"string"}},"additionalProperties":false},"startPrice":{"type":"object","required":["currencyCode","units"],"properties":{"units":{"type":"string"},"currencyCode":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"reservable":{"type":"boolean"},"servesBeer":{"type":"boolean"},"servesWine":{"type":"boolean"},"websiteUri":{"type":"string"},"displayName":{"type":"object","required":["text","languageCode"],"properties":{"text":{"type":"string"},"languageCode":{"type":"string"}},"additionalProperties":false},"primaryType":{"type":"string"},"servesLunch":{"type":"boolean"},"servesBrunch":{"type":"boolean"},"servesCoffee":{"type":"boolean"},"servesDinner":{"type":"boolean"},"goodForGroups":{"type":"boolean"},"googleMapsUri":{"type":"string"},"servesDessert":{"type":"boolean"},"businessStatus":{"type":"string"},"curbsidePickup":{"type":"boolean"},"outdoorSeating":{"type":"boolean"},"parkingOptions":{"type":"object","properties":{"valetParking":{"type":"boolean"},"freeParkingLot":{"type":"boolean"},"paidParkingLot":{"type":"boolean"},"freeGarageParking":{"type":"boolean"},"freeStreetParking":{"type":"boolean"},"paidGarageParking":{"type":"boolean"},"paidStreetParking":{"type":"boolean"}},"additionalProperties":false},"paymentOptions":{"type":"object","properties":{"acceptsNfc":{"type":"boolean"},"acceptsCashOnly":{"type":"boolean"},"acceptsDebitCards":{"type":"boolean"},"acceptsCreditCards":{"type":"boolean"}},"additionalProperties":false},"goodForChildren":{"type":"boolean"},"servesBreakfast":{"type":"boolean"},"servesCocktails":{"type":"boolean"},"userRatingCount":{"type":"number"},"editorialSummary":{"type":"object","required":["text","languageCode"],"properties":{"text":{"type":"string"},"languageCode":{"type":"string"}},"additionalProperties":false},"formattedAddress":{"type":"string"},"currentOpeningHours":{"type":"object","properties":{"openNow":{"type":"boolean"},"periods":{"type":"array","items":{"type":"object","properties":{"open":{"type":"object","required":["day","hour","minute"],"properties":{"day":{"type":"number"},"hour":{"type":"number"},"minute":{"type":"number"}},"additionalProperties":false},"close":{"type":"object","required":["day","hour","minute"],"properties":{"day":{"type":"number"},"hour":{"type":"number"},"minute":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false}},"weekdayDescriptions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"nationalPhoneNumber":{"type":"string"},"regularOpeningHours":{"type":"object","properties":{"openNow":{"type":"boolean"},"periods":{"type":"array","items":{"type":"object","properties":{"open":{"type":"object","required":["day","hour","minute"],"properties":{"day":{"type":"number"},"hour":{"type":"number"},"minute":{"type":"number"}},"additionalProperties":false},"close":{"type":"object","required":["day","hour","minute"],"properties":{"day":{"type":"number"},"hour":{"type":"number"},"minute":{"type":"number"}},"additionalProperties":false}},"additionalProperties":false}},"weekdayDescriptions":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"accessibilityOptions":{"type":"object","properties":{"wheelchairAccessibleParking":{"type":"boolean"},"wheelchairAccessibleSeating":{"type":"boolean"},"wheelchairAccessibleEntrance":{"type":"boolean"},"wheelchairAccessibleRestroom":{"type":"boolean"}},"additionalProperties":false},"servesVegetarianFood":{"type":"boolean"},"goodForWatchingSports":{"type":"boolean"},"internationalPhoneNumber":{"type":"string"}},"additionalProperties":false}},"nextPageToken":{"type":"string","description":"Pagination cursor for the next page. Copy verbatim into pageToken on the next request (~200+ chars; do not truncate)."}},"additionalProperties":false},"example":{"request":{"languageCode":"en","excludeFields":["photos"],"includedTypes":["restaurant"],"maxResultCount":5,"rankPreference":"POPULARITY","locationRestriction":{"circle":{"center":{"latitude":40.758,"longitude":-73.9855},"radius":1000}}},"response":{"places":[{"id":"ChIJifIePKtZwokRVZ-UdRGkZzs","types":["pizza_restaurant","pizza_delivery","meal_delivery","food_delivery","restaurant","food","point_of_interest","establishment"],"location":{"latitude":40.754679499999995,"longitude":-73.9870291},"displayName":{"text":"Joe's Pizza Broadway","languageCode":"en"},"primaryType":"pizza_restaurant","formattedAddress":"1435 Broadway, New York, NY 10018, USA"},{"id":"ChIJzRA7agBZwokRbSxOyEGFG5U","types":["taiwanese_restaurant","dumpling_restaurant","chinese_restaurant","restaurant","food","point_of_interest","establishment"],"location":{"latitude":40.7619804,"longitude":-73.98395970000001},"displayName":{"text":"Din Tai Fung 鼎泰豐","languageCode":"en"},"primaryType":"taiwanese_restaurant","formattedAddress":"1633 Broadway, New York, NY 10019, USA"},{"id":"ChIJ_85dJlZYwokR29NPLSJngR4","types":["diner","american_restaurant","restaurant","food","point_of_interest","establishment"],"location":{"latitude":40.7618723,"longitude":-73.98343559999999},"displayName":{"text":"Ellen's Stardust Diner","languageCode":"en"},"primaryType":"diner","formattedAddress":"1650 Broadway, New York, NY 10019, USA"},{"id":"ChIJ6WooklRYwokR3qd-J59t-k0","types":["taco_restaurant","mexican_restaurant","restaurant","food","point_of_interest","establishment"],"location":{"latitude":40.757321399999995,"longitude":-73.98765399999999},"displayName":{"text":"LOS TACOS No.1","languageCode":"en"},"primaryType":"taco_restaurant","formattedAddress":"229 W 43rd St, New York, NY 10036, USA"},{"id":"ChIJb7P5f9FZwokR2HSsdIIDLls","types":["fast_food_restaurant","chicken_restaurant","american_restaurant","restaurant","food","point_of_interest","establishment"],"location":{"latitude":40.757361599999996,"longitude":-73.9862806},"displayName":{"text":"Raising Cane's Chicken Fingers","languageCode":"en"},"primaryType":"fast_food_restaurant","formattedAddress":"1501 Broadway, New York, NY 10036, USA"}]}},"exampleRequest":{"languageCode":"en","excludeFields":["photos"],"includedTypes":["restaurant"],"maxResultCount":5,"rankPreference":"POPULARITY","locationRestriction":{"circle":{"center":{"latitude":40.758,"longitude":-73.9855},"radius":1000}}},"tags":["apollo","exa","firecrawl","google-maps","linkedin","reddit","enrichment","research","data","search","social","x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":3,"rating":{"score":"0.81","successRate":"0.89","reviews":3,"stars":"4.2","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_l04k0Pxim-QnjUBllYmPN","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_dgOHW531ShaWy9RNzyAzX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"StableEnrich","brandSlug":"stableenrich","brandBaseUrl":"https://stableenrich.dev","brandDocsUrl":"https://stableenrich.dev","whatItDoes":"Search for nearby places on Google Maps within a geographic radius, returning partial place details like ratings, reviews, types, and amenities.","exampleAgentPrompt":"Find me up to 5 highly popular restaurants within 1000 meters of latitude 40.7580, longitude -73.9855, ranked by popularity — include ratings and whether they offer dine-in or takeout.","exampleUseCases":null,"resultDescription":"An array of up to 5 place objects, each containing a place ID, types, rating, reviews, location coordinates, price level/range, and amenity flags such as dine-in, takeout, delivery, restroom, live music, allows dogs, and reservable status.","failureModes":["Missing required locationRestriction.circle.center or radius returns a validation error","radius exceeds 50000 meters causes schema validation failure","includedTypes or excludedTypes array exceeds 50 items returns error","Invalid latitude/longitude values (out of range) cause API rejection","No places found in the specified area returns an empty places array","Network timeout or upstream Google Maps API unavailability returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need a quick, cost-effective nearby place search (partial fields) and don't require the full place detail set. Prefer over the Full version when you only need ratings, reviews, types, amenities, and coordinates — not exhaustive place metadata — to save on response size and cost.","instructions":null,"reviewSummary":"Google Maps Nearby Search (Partial) reliably returns up to 5 accurate location results with correct addresses within fast response times (sub-second to ~4s), making it well-suited for agentic location-recommendation workflows. At $0.02 per call it offers strong value for place discovery, but the Partial tier is hard-capped to name and formattedAddress — rating, userRatingCount, and hours fields return null regardless of field configuration. Use the Full variant when ratings or business hours are required.","reviewSummaryHighlights":["Fast response times, typically sub-second to ~4 seconds for 5-result queries","Accurate real-world results with correct addresses across tested locations","Clean, well-typed schema closely matching Google Places v1 New API; easy to integrate"],"reviewSummaryConcerns":["Rating, hours, and userRatingCount fields are always null — field exclusion settings have no effect on this tier","Occasional non-matching result types (e.g., hotel appearing in restaurant searches)"],"reviewSummaryGeneratedAt":"2026-07-02T22:28:33.783Z","activationCount":19,"lastUsedAt":"2026-07-02T20:31:53.652Z","lastSuccessfullyRanAt":"2026-07-02T20:31:53.652Z","lastHealthCheckAt":"2026-10-10T04:13:55.540Z","isFirstParty":false,"canonicalSlug":"stableenrich-partial-7e15db87"}