Google Places API Proxy

This service provides a simplified interface for mapping human-readable domains and aliases to Google Place IDs.

Note: This is a REST API service. This HTML page is just for documentation.

API Endpoint

GET /api/v1/places?[domain={DOMAIN}]&[alias={ALIAS}]&[fields={comma,separated,fields}]&[key={CLIENT_KEY}]&[refresh=true|false]

Usage Examples

Domain with default alias:

GET /api/v1/places?domain=example.com&alias=default

Domain with specific alias:

GET /api/v1/places?domain=multi-location.org&alias=berlin

Important: An alias is always required. Every domain must have at least one alias configured.

Custom fields:

GET /api/v1/places?domain=example.com&fields=name,rating,formatted_address

With client API key:

GET /api/v1/places?domain=example.com&key=client-api-key

Force refresh (bypass cache):

GET /api/v1/places?domain=example.com&refresh=true

Warning: Use the refresh=true parameter with caution. This will force a new request to the Google Places API and bypass/reset the cache. This should only be used when you suspect the cached data is incorrect or outdated.

All results are normally cached for 30 days to optimize performance and reduce API usage.