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

All parameters are optional.

Query parameters

number
The latitude of the user’s location (e.g. 6.4281). When provided alongside lng, results are biased toward nearby restaurants.
number
The longitude of the user’s location (e.g. 3.4219). Use together with lat.
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.
string
required
The restaurant’s display name (e.g. "Yellow Chilli").
string
required
The restaurant’s neighborhood or street-level address (e.g. "Victoria Island, Lagos").
number
required
The Google Places average star rating for this restaurant (e.g. 4.3).
number
required
A Google Places price level on a scale of 0–4, where 0 is free and 4 is very expensive.
string
required
The Google Places place_id for this restaurant. Pass this value to /place-details/{place_id} to retrieve full details.
string[]
required
A list of Google Places category tags for this restaurant (e.g. ["restaurant", "food"]).
string
A Google Maps photo URL for this restaurant. May be null if no photo is available.

Example

Errors