Google Maps text search returning full place details including ratings, reviews, contact info, and atmosphere data at $0.08/request.
What it does
This endpoint performs a Google Maps text search with full field details via StableEnrich's pay-per-request proxy. Send a natural-language text query (e.g., "coffee shops in San Francisco") and receive up to 5 place results with comprehensive data: display name, formatted address, lat/lng coordinates, ratings, user rating count, reviews, opening hours, phone numbers, website URI, price level, editorial summary, and atmosphere flags (dine-in, delivery, outdoor seating, live music, etc.).
The endpoint is a POST accepting a JSON body with a required `textQuery` string and optional parameters: `maxResultCount` (1–5, default 5), `locationBias` (circle with center lat/lng and radius up to 50km), `includedType`, `openNow`, `minRating`, `priceLevels`, `languageCode`, and `pageToken` for pagination. An `excludeFields` array defaults to `["photos"]` to reduce response size; pass an empty array to include photo metadata. Pagination is supported via `nextPageToken` in responses.
Priced at $0.08 per request (fixed, in USD). Payment is handled via MPP (Tempo method, pathUSD currency) or x402 on Base mainnet. No API keys or subscriptions required — payment is authentication. A lower-cost partial variant at $0.02/request is available at `/api/google-maps/text-search/partial` with the same request schema but fewer response fields. Part of the StableEnrich platform by Merit Systems, which aggregates Google Maps, Apollo, Exa, Firecrawl, Clado, Serper, Whitepages, Reddit, Hunter, Influencer, Minerva, and Cloudflare APIs behind a single micropayment interface.
Capabilities
Use cases
- —Finding businesses matching a text query with full details (ratings, reviews, hours, contact info)
- —Building location-aware recommendation features for agents
- —Competitive analysis of local businesses including reviews and atmosphere data
- —Lead generation by discovering businesses in a geographic area
- —Enriching CRM records with place details like phone numbers and websites
Fit
Best for
- —Agents needing rich place data (reviews, hours, atmosphere) in a single call
- —Pay-per-use Google Maps queries without API key management
- —Combining with other StableEnrich endpoints for multi-source research pipelines
Not for
- —High-volume batch geocoding (no geocode endpoint exposed)
- —Free-tier or zero-cost place lookups
- —Retrieving only basic place info (use the $0.02 partial variant instead)
Quick start
POST https://stableenrich.dev/api/google-maps/text-search/full
Content-Type: application/json
{
"textQuery": "coffee shops in San Francisco",
"maxResultCount": 3
}Example
Request
{
"textQuery": "coffee shops in San Francisco",
"locationBias": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 5000
}
},
"maxResultCount": 3
}Response
{
"places": [
{
"id": "ChIJExample123",
"dineIn": true,
"rating": 4.5,
"delivery": false,
"location": {
"latitude": 37.7821,
"longitude": -122.4015
},
"priceLevel": "PRICE_LEVEL_MODERATE",
"websiteUri": "https://bluebottlecoffee.com",
"displayName": {
"text": "Blue Bottle Coffee",
"languageCode": "en"
},
"servesCoffee": true,
"googleMapsUri": "https://maps.google.com/?cid=12345",
"userRatingCount": 1823,
"formattedAddress": "66 Mint St, San Francisco, CA 94103",
"nationalPhoneNumber": "(510) 653-3394",
"regularOpeningHours": {
"openNow": true,
"weekdayDescriptions": [
"Monday: 7:00 AM – 6:00 PM"
]
}
}
],
"nextPageToken": "abc123..."
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response types, clear pricing ($0.08/request in USD), comprehensive documentation in guidance, and examples provided. The endpoint returned 405 on HEAD/GET probes (expected since it's POST-only), but the OpenAPI spec and x-payment-info confirm it is live and properly configured.
Warnings
- —Probe returned 405 on HEAD and GET because this is a POST-only endpoint; this does not indicate the endpoint is down.
- —maxResultCount capped at 5; docs recommend using 1–3 to avoid excessive context in agent workflows.
Citations
- —Price is $0.08 per request, fixed, in USDhttps://stableenrich.dev
- —Full details include ratings, reviews, contact info, and atmosphere datahttps://stableenrich.dev
- —Payment processed on Base mainnet (eip155:8453), Solana, or Tempohttps://stableenrich.dev/docs
- —Partial variant available at $0.02/request with same request bodyhttps://stableenrich.dev
- —excludeFields defaults to ["photos"] for Google Maps endpointshttps://stableenrich.dev