Skip to main content
The NaijaTaste REST API lets you programmatically generate Nigerian-style restaurant reviews and get personalized restaurant recommendations powered by the Nigerian Persona Engine. You can integrate review simulation, location-based discovery, and restaurant detail lookups directly into your own application using standard HTTP requests.

​
Base URL

All API requests go to the following base URL:
Use the interactive Swagger UI at https://naijataste-api-vcp4-vcp4.onrender.com/docs to explore and test all endpoints without writing any code.

​
Making requests

Every request and response uses JSON. Set the Content-Type header to application/json on all requests that include a body.
The API returns a JSON object for every response, including errors.

​
Available endpoints

​
Error codes

The API uses standard HTTP status codes. When a request fails, the response body contains a JSON object with details about the error. 422 Unprocessable Entity is returned when required fields are missing from the request body — for example, when neither user_id nor persona is provided to /simulate-review, or when neither user_id nor cold_start_signals is provided to /recommend. 503 Service Unavailable is returned when an external dependency — Google Places or Gemini AI — cannot be reached or is not configured.

​
Rate limiting

During high-traffic periods, the API’s AI service layer may become temporarily rate-limited. If this happens, you will receive a 502 or 503 error response. Wait approximately 60 seconds before retrying your request.
Implement retry logic with a short delay in production integrations. A 60-second wait before retrying is usually sufficient during peak periods.