# NaijaTaste

> AI-powered Nigerian restaurant recommendations and review simulation with authentic Pidgin English output.

## Docs

- [Your NaijaTaste Profile, Persona Level and Traits](https://trailblazer.mintlify.app/account/profile.md): Your profile page shows your persona level, calculated taste traits, and full review history — all updated automatically as you generate reviews.
- [Viewing and Managing Your NaijaTaste Saved Reviews](https://trailblazer.mintlify.app/account/saved-reviews.md): Reviews you generate while signed in are saved automatically to your profile, building the taste history that shapes your persona and future simulations.
- [Sign in to NaijaTaste Using Your Google Account](https://trailblazer.mintlify.app/account/sign-in.md): Sign in with Google to unlock personalized review personas, automatic review saving, persona levels, and your Flavor Finder dashboard.
- [NaijaTaste API authentication and access](https://trailblazer.mintlify.app/api/authentication.md): The NaijaTaste API is publicly accessible — no API key, token, or Authorization header is needed on any endpoint, with a paid tier planned for higher quotas.
- [GET /cache/stats — View cached Places statistics](https://trailblazer.mintlify.app/api/cache-stats.md): Retrieve statistics on Google Places queries in the server-side cache, including query terms, locations, restaurant result counts, and cache timestamps.
- [GET /health — Check the NaijaTaste API health](https://trailblazer.mintlify.app/api/health.md): Check whether the NaijaTaste API is running and reachable. Returns a simple status object. Also accepts HEAD requests for lightweight uptime monitoring.
- [NaijaTaste REST API overview](https://trailblazer.mintlify.app/api/overview.md): What the NaijaTaste REST API does, the base URL, the six endpoints for recommendations and reviews, request formats, and how errors are returned.
- [GET /place-details/{place_id} — Restaurant details](https://trailblazer.mintlify.app/api/place-details.md): Fetch full details for a restaurant by Google Places place_id, including address, phone number, opening hours, photos, and real-time open/closed status.
- [POST /recommend — Get restaurant recommendations](https://trailblazer.mintlify.app/api/recommend.md): Get up to five personalized Nigerian restaurant recommendations from review history or cold-start signals including city, food preference, and price range.
- [POST /simulate-review — Generate a Nigerian review](https://trailblazer.mintlify.app/api/simulate-review.md): Generate an authentic Nigerian restaurant review with a star rating, review text, and tone label by supplying a user persona and restaurant features.
- [GET /places/top-picks — Top Nigerian restaurants](https://trailblazer.mintlify.app/api/top-picks.md): Retrieve up to six top-rated Nigerian restaurants, optionally ranked by GPS proximity and tuned to a specific reviewer persona's tastes and preferences.
- [NaijaTaste REST API channel for developers](https://trailblazer.mintlify.app/channels/api.md): Call the NaijaTaste REST API to embed Nigerian restaurant recommendations, Pidgin review generation, and top picks into your own product with no authentication.
- [Use NaijaTaste on the web app](https://trailblazer.mintlify.app/channels/web.md): Search Nigerian restaurants and generate Pidgin reviews on the web app using chat mode, form mode, voice input, or GPS — no account required to start.
- [Chat with NaijaTaste on WhatsApp](https://trailblazer.mintlify.app/channels/whatsapp.md): Chat with NaijaTaste on WhatsApp in Pidgin, Yoruba, Hausa, Igbo, or English to get Nigerian restaurant picks and reviews without opening a browser.
- [NaijaTaste API keys and the planned auth tier](https://trailblazer.mintlify.app/developers/api-keys.md): Core NaijaTaste endpoints need no API key today. Learn how the upcoming authenticated tier handles keys, rate limits, webhooks, and storage best practices.
- [NaijaTaste developer API overview and endpoints](https://trailblazer.mintlify.app/developers/overview.md): Public REST API for Nigerian restaurant recommendations and Pidgin review generation — endpoints, base URL, multilingual input, implicit learning, and errors.
- [NaijaTaste API rate limits and 429 handling](https://trailblazer.mintlify.app/developers/rate-limits.md): Per-IP rate limits on the NaijaTaste public API, the X-RateLimit response headers, 429 retry-after handling, and how to request higher production limits.
- [NaijaTaste API webhooks for event notifications](https://trailblazer.mintlify.app/developers/webhooks.md): Planned NaijaTaste webhook events, how to register an endpoint, HMAC-SHA256 signature verification, and the retry schedule for failed deliveries.
- [Taste Personas: Customize Your Flavor Profile](https://trailblazer.mintlify.app/features/personas.md): Taste personas define how you eat — your budget, vibe, and priorities. Choose a preset, build your own, or let your review history create one for you.
- [Recommendation Engine: Find Nigerian Restaurants](https://trailblazer.mintlify.app/features/recommendation-engine.md): Get ranked Nigerian restaurant picks from real Google Places data, personalised by your taste persona, city preference, or live GPS location.
- [Review Simulator: Predict Nigerian Restaurant Reviews](https://trailblazer.mintlify.app/features/review-simulator.md): Simulate how any Nigerian taste persona would review a restaurant — star rating, authentic Pidgin English text, and tone label, all in one call.
- [Find Nigerian restaurants by craving or location](https://trailblazer.mintlify.app/food-lovers/find-restaurants.md): Search Nigerian restaurants four ways — chat, form, WhatsApp in five languages, or GPS — and read ranked results tuned by your persona, price, and city.
- [Generate authentic Nigerian restaurant reviews](https://trailblazer.mintlify.app/food-lovers/generate-reviews.md): Use the Review Simulator on web, WhatsApp, or the API to generate Pidgin, English, Yoruba, Hausa, or Igbo reviews with a star rating and tone label.
- [NaijaTaste for food lovers: features overview](https://trailblazer.mintlify.app/food-lovers/overview.md): Find Nigerian restaurants, simulate reviews, and build a taste profile across the web app, WhatsApp, and API — in English, Pidgin, Yoruba, Hausa, or Igbo.
- [Your NaijaTaste profile and how it learns](https://trailblazer.mintlify.app/food-lovers/taste-profile.md): How your NaijaTaste taste profile records persona, price, cuisine, tone, and language signals — and progresses through Discovering to Authority levels.
- [Find Restaurants with Chat Mode](https://trailblazer.mintlify.app/guides/chat-mode.md): Type your craving in plain language on the recommendation page and get instant Nigerian restaurant picks tailored to your city and taste.
- [Find Restaurants with Form Mode](https://trailblazer.mintlify.app/guides/form-mode.md): Use the structured form on the recommendation page to filter Nigerian restaurants by city, food preference, and price range for precise results.
- [Use GPS for Hyper-Local Restaurant Picks](https://trailblazer.mintlify.app/guides/geolocation.md): Grant browser location access on the recommendation page to search within 5km of where you are, not just the city centre, for more accurate results.
- [How NaijaTaste works, end to end](https://trailblazer.mintlify.app/how-it-works.md): Walk through a real NaijaTaste session — search, persona scoring, ranked picks, Pidgin review generation, profile sharpening, and API integration in one flow.
- [Introduction](https://trailblazer.mintlify.app/introduction.md): Discover what NaijaTaste does, who it's for, and how its two core features and Nigerian Persona Engine set it apart from generic food apps.
- [The mission](https://trailblazer.mintlify.app/mission.md): Why NaijaTaste exists, the food discovery problem it solves in Nigeria, and how culturally calibrated personas change how diners and vendors connect.
- [Feedback loop](https://trailblazer.mintlify.app/persona-engine/feedback-loop.md): How every NaijaTaste search, click, and review feeds your persona, adjusts cuisine and price weights, and moves you through the four persona levels.
- [How the Nigerian Persona Engine works](https://trailblazer.mintlify.app/persona-engine/how-it-works.md): Inside the Nigerian Persona Engine — restaurant scoring weights, review tone calibration, multilingual output detection, and the implicit learning loop.
- [The three archetypes](https://trailblazer.mintlify.app/persona-engine/the-three-archetypes.md): The Lagos Professional, the Street Food Enthusiast, and The Aunty — how each archetype shapes your recommendations and review style.
- [NaijaTaste quick start: web, WhatsApp, or API](https://trailblazer.mintlify.app/quick-start.md): Pick one of three paths to try NaijaTaste in minutes — the web app demo, the WhatsApp sandbox in five Nigerian languages, or a no-auth REST API call.
- [Data privacy](https://trailblazer.mintlify.app/security/data-privacy.md): NaijaTaste data retention windows, the third-party services used (Google Places, OAuth), your NDPR rights, cookies, encryption, and how to delete your account.
- [NaijaTaste security and data handling overview](https://trailblazer.mintlify.app/security/overview.md): What NaijaTaste collects, what we never collect or sell, the controls you have over your taste profile, how we store data, and our NDPR compliance commitments.
- [Get your restaurant discovered on NaijaTaste](https://trailblazer.mintlify.app/vendors/get-discovered.md): Optimise your Google Business Profile for NaijaTaste visibility — verify details, gather honest reviews, keep hours accurate, and tag cuisine like diners do.
- [NaijaTaste for restaurants and food vendors](https://trailblazer.mintlify.app/vendors/overview.md): How NaijaTaste ranks restaurants from Google Places data — the signals we read, why there is no paid placement, and four steps to improve your discoverability.
- [How Google review signals affect your ranking](https://trailblazer.mintlify.app/vendors/review-signals.md): How Google star ratings, review count, and recency translate into NaijaTaste rankings, plus how persona calibration weights service, value, and quality.

## Optional

- [Live Demo](https://naijataste.onrender.com)
- [API Playground](https://naijataste-api-vcp4.onrender.com/docs)