Skip to main content
The /places/top-picks endpoint returns up to six highly rated Nigerian restaurants sourced from Google Places. You can pass GPS coordinates to surface restaurants close to a specific location, and optionally supply a persona title to influence how results are ranked. This is a lightweight discovery endpoint — use /place-details/{place_id} to retrieve full information for any restaurant in the list.

Request

GET https://naijataste-api-vcp4.onrender.com/places/top-picks
All parameters are optional.

Query parameters

lat
number
The latitude of the user’s location (e.g. 6.4281). When provided alongside lng, results are biased toward nearby restaurants.
lng
number
The longitude of the user’s location (e.g. 3.4219). Use together with lat.
persona
string
default:"Curious Taster"
A persona title that affects how results are ranked and filtered. Defaults to "Curious Taster" when omitted.

Response

The response is an array of up to six restaurant objects.
name
string
required
The restaurant’s display name (e.g. "Yellow Chilli").
vicinity
string
required
The restaurant’s neighborhood or street-level address (e.g. "Victoria Island, Lagos").
rating
number
required
The Google Places average star rating for this restaurant (e.g. 4.3).
price_level
number
required
A Google Places price level on a scale of 0–4, where 0 is free and 4 is very expensive.
place_id
string
required
The Google Places place_id for this restaurant. Pass this value to /place-details/{place_id} to retrieve full details.
types
string[]
required
A list of Google Places category tags for this restaurant (e.g. ["restaurant", "food"]).
photo_url
string
A Google Maps photo URL for this restaurant. May be null if no photo is available.

Example

curl "https://naijataste-api-vcp4.onrender.com/places/top-picks?lat=6.4281&lng=3.4219&persona=Curious%20Taster"

Errors

StatusCause
503The Google Places API key is not configured or the service is unreachable.