> ## Documentation Index
> Fetch the complete documentation index at: https://trailblazer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```text theme={null}
https://naijataste-api-vcp4.onrender.com
```

No authentication required for core endpoints.

## Quick calls

### Get recommendations

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
curl https://naijataste-api-vcp4.onrender.com/health
# {"status": "ok"}
```

## Interactive playground

Test every endpoint in the browser: [naijataste-api.onrender.com/docs](https://naijataste-api-vcp4.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               |

<Card title="Full API reference" icon="book-open" href="/developers/overview">
  Request schemas, response formats, error codes, and rate limits.
</Card>