NaijaTaste REST API channel for developers

Call the NaijaTaste REST API to embed Nigerian restaurant recommendations, Pidgin review generation, and top picks into your own product with no authentication.

The REST API gives you programmatic access to the same intelligence behind the web app and WhatsApp agent.

Base URL

https://naijataste-api-vcp4.onrender.com

No authentication required for core endpoints.

Quick calls

Get recommendations

curl -X POST https://naijataste-api-vcp4.onrender.com/recommend \
  -H "Content-Type: application/json" \
  -d '{
    "cold_start_signals": {
      "city": "Lagos",
      "preferred_food": "suya",
      "price_range": "budget"
    }
  }'

Generate a review

curl -X POST https://naijataste-api-vcp4.onrender.com/simulate-review \
  -H "Content-Type: application/json" \
  -d '{
    "persona": {
      "avg_rating": 4.2,
      "rating_tendency": "balanced",
      "price_sensitivity": "medium",
      "tone_keywords": ["jollof", "value", "service"]
    },
    "item_name": "Mama Bola Buka",
    "item_type": "restaurant",
    "location": "Lagos",
    "features": ["correct stew", "fast service", "affordable"]
  }'

Top picks near me

curl "https://naijataste-api-vcp4.onrender.com/places/top-picks?user_lat=6.5244&user_lng=3.3792&persona_title=Street+Food+Enthusiast"

Check health

curl https://naijataste-api-vcp4.onrender.com/health
# {"status": "ok"}

Interactive playground

Test every endpoint in the browser: naijataste-api.onrender.com/docs

All endpoints

Method	Path	Description
POST	/recommend	Get restaurant recommendations
POST	/simulate-review	Generate a Nigerian review
GET	/places/top-picks	Top-rated restaurants
GET	/place-details/{place_id}	Full restaurant detail
GET	/cache/stats	Cached query statistics
GET	/health	API health check

Full API reference

Request schemas, response formats, error codes, and rate limits.