Skip to main content
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

MethodPathDescription
POST/recommendGet restaurant recommendations
POST/simulate-reviewGenerate a Nigerian review
GET/places/top-picksTop-rated restaurants
GET/place-details/{place_id}Full restaurant detail
GET/cache/statsCached query statistics
GET/healthAPI health check

Full API reference

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