Google Maps Nearby Search returning basic place details at $0.02/request via micropayment
What it does
This endpoint performs a Google Maps Nearby Search with partial (basic) field details. You provide a geographic center point and radius to define a circular search area, and optionally filter by place types, language, and rank preference (popularity or distance). It returns up to 5 places per request with fields like display name, address, location coordinates, place types, business status, Google Maps URI, and basic attributes. Photos are excluded by default but can be included by passing an empty excludeFields array.
The endpoint is part of StableEnrich, a pay-per-request API gateway that unifies multiple data sources behind micropayment authentication. It costs $0.02 per request and accepts payment via x402 (USDC on Base mainnet) or MPP (pathUSD on Tempo L2). No API keys or subscriptions are required — payment itself serves as authentication. The response includes a nextPageToken for pagination through additional results.
Compared to the full variant (/api/google-maps/nearby-search/full at $0.08/request), this partial endpoint omits detailed review text, atmosphere data, and extended contact information, making it suitable for lightweight discovery queries where cost efficiency matters. The request body requires a locationRestriction object with a circle definition (center lat/lng and radius in meters, max 50,000). Results can be filtered by includedTypes and excludedTypes arrays (up to 50 items each).
Capabilities
Use cases
- —Finding restaurants, shops, or services near a specific GPS coordinate
- —Building location-aware agent workflows that discover nearby businesses on a budget
- —Lightweight place discovery before drilling into full details with the /full variant
- —Populating map interfaces with basic place markers in a geographic area
- —Screening nearby businesses by type before enriching selected ones
Fit
Best for
- —Cost-sensitive nearby place discovery at $0.02/call
- —Agents that need basic place info (name, address, coordinates, type) without reviews or atmosphere data
- —Programmatic geo-search without API key management or subscription overhead
- —Iterative location scouting where many searches are needed across different areas
Not for
- —Getting detailed reviews, ratings breakdowns, or atmosphere data (use the /full variant at $0.08)
- —Text-based place search without a known geographic center (use /text-search/partial instead)
- —Looking up a single known place by ID (use /place-details/partial instead)
Quick start
POST https://stableenrich.dev/api/google-maps/nearby-search/partial
Content-Type: application/json
{
"locationRestriction": {
"circle": {
"center": { "latitude": 37.7749, "longitude": -122.4194 },
"radius": 1000
}
},
"includedTypes": ["restaurant"],
"maxResultCount": 5
}Example
Request
{
"languageCode": "en",
"includedTypes": [
"restaurant"
],
"maxResultCount": 5,
"rankPreference": "POPULARITY",
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7749,
"longitude": -122.4194
},
"radius": 1000
}
}
}Response
{
"places": [
{
"id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
"types": [
"restaurant",
"food",
"point_of_interest"
],
"location": {
"latitude": 37.7762,
"longitude": -122.4108
},
"displayName": {
"text": "The Italian Homemade Company",
"languageCode": "en"
},
"primaryType": "restaurant",
"googleMapsUri": "https://maps.google.com/?cid=12345",
"businessStatus": "OPERATIONAL",
"formattedAddress": "716 Columbus Ave, San Francisco, CA 94133"
}
],
"nextPageToken": "AbCdEf123..."
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request/response definitions, clear pricing ($0.02 USD fixed), documented payment protocols (x402 + MPP/Tempo), comprehensive guidance text, and examples. The probe returned 405 because HEAD/GET were tried on a POST-only endpoint, which is expected behavior — the endpoint is confirmed live via the OpenAPI spec and consistent pricing metadata.
Warnings
- —Probe returned 405 because HEAD and GET were attempted on a POST-only endpoint; this does not indicate the endpoint is down.
- —No actual 402 challenge was captured for this specific endpoint due to method mismatch during probing.
Citations
- —Nearby Search (Partial) costs $0.02 per requesthttps://stableenrich.dev
- —Endpoint accepts locationRestriction with circle center/radius, includedTypes, excludedTypes, maxResultCount (1-5), rankPreference (POPULARITY/DISTANCE)https://stableenrich.dev
- —Payment is processed via x402 (USDC on Base mainnet) or MPP (pathUSD on Tempo L2)https://stableenrich.dev
- —Photos are excluded by default in Google Maps endpoints; pass empty excludeFields array to include themhttps://stableenrich.dev
- —Google Maps search endpoints support pagination via pageToken returned as nextPageTokenhttps://stableenrich.dev