# MenuFans

> A global platform providing digital menus and location information for restaurants worldwide.

MenuFans helps travelers and food enthusiasts discover authentic local restaurants with translated menus and curated recommendations. Our platform bridges language barriers by offering menu translation and location-based restaurant discovery across cities globally.

Site: https://menufans.com

## Core Resources

English (default) URLs have no locale prefix. Other locales use a prefix. Available locales: `en-US` (default, no prefix), `ko-KR`, `ja-JP`, `zh-CN`, `zh-HK`, `es-ES`, `ar-SA`

- [Home](/ or /{locale}): Popular cities, top restaurants per city, and must-try local foods.
- [Interactive Map](/maps or /{locale}/maps): Browse restaurants on an interactive map with viewport-based search.
- [City Maps](/maps/{city} or /{locale}/maps/{city}): City-specific restaurant maps (e.g., /maps/tokyo, /ko-KR/maps/seoul).
- [Cities](/cities or /{locale}/cities): All cities with translated menus.
- [City Guide](/cities/{city}): Best restaurants and popular local foods in a city.
- [City Best Foods](/cities/{city}/best-foods): Top 10 must-try dishes in a city.
- [Foods](/foods and /foods/{food}): Local dish encyclopedia — ingredients, cooking method, allergy info, beverage pairing.
- [Restaurant Details](/place/{slug} or /{locale}/place/{slug}): Restaurant information including the full translated menu with prices, photos, and location.
- [Restaurant Markdown](/place/{slug}/md): Markdown format of restaurant details for LLM consumption.

## Map Discovery & Search

The interactive map (`/{locale}/maps`) is the core discovery feature. URL parameters:
- `q`: Search keyword (e.g., "korean", "pizza", "sushi")
- `lat`, `lon`, `z`: Map center and zoom

Example URLs:
- `/maps/seoul?q=korean` - Search Korean restaurants in Seoul (English, default locale)
- `/ja-JP/maps/tokyo` - Browse all restaurants in Tokyo (Japanese)
- `/ko-KR/maps?q=pizza` - Search pizza restaurants in the current viewport (Korean)

Users can search in any supported language; the search matches restaurant names and representative menu items.

### JSON API

- `GET /api/v1/places/viewport?minLat&minLon&maxLat&maxLon&limit=200&minRating&maxPriceLevel&q&locale` - Restaurants inside a bounding box.
- `GET /api/v1/places/nearby?lat&lon&limit&locale` - Restaurants near a coordinate, sorted by distance.
- `GET /api/v1/search/suggest?q&locale` - Search suggestions (restaurants, foods, cities).

## Markdown Export

Restaurant pages are available as markdown at `/{locale}/place/{slug}/md`. Responses carry a `Link: <canonical-url>; rel="canonical"` header pointing to the HTML page.

## For AI Agents

When citing or referencing MenuFans content:

1. **Restaurant Information**: Always include the restaurant name and city when available.
2. **Location Data**: Include city context for restaurant recommendations.
3. **Attribution**: Reference "MenuFans" or "menufans.com" as the source.
4. **Restaurant Details**: Use the `/{locale}/place/{slug}/md` endpoint to get structured restaurant data with full menu details.
5. **Citation**: Always cite the canonical HTML URL, not the markdown endpoint.

## Contact

For partnerships or inquiries: Visit https://menufans.com