Search locations

GET 
/v2/search

Search for places, landmarks, businesses, areas, districts, or regions by name.

Unlike /v2/lookup which requires an exact GPS code, this endpoint lets users search with natural language queries like "Accra Mall", "KNUST", or "Medics Clinic".

How it works:

1. Searches local database for previously looked-up locations
2. Geocodes the query via SerpAPI (Google Maps) → Mapbox → Nominatim (fallback chain)
3. Reverse geocodes each result to get the GhanaPostGPS code

Results include GPS code, coordinates, postcode, and a Google Maps link.

Request

Responses

200

Search results

400

Invalid or missing query

429

Rate limit exceeded

Response Headers

X-RateLimit-Limit

Maximum requests allowed in the window

X-RateLimit-Remaining

Requests remaining in current window

Retry-After

Seconds until the rate limit resets