# POS.DO — Restaurant Discovery Platform

> Helping people discover "YOUR next favorite restaurant" through cultural context, real reviews, and time-based offers across 25+ countries.

## What is POS.DO

POS.DO is a multilingual restaurant discovery platform covering 384,000+ restaurants across 25+ countries in 7 languages (Spanish, English, Italian, French, German, Portuguese, Catalan). Unlike rating-centric platforms, POS.DO enriches restaurant profiles with cultural context from Wikidata (nearby monuments, museums, parks) and offers time-based discounts through POS.DO Flow.

## Coverage

- **Countries**: USA (140K), Spain (95K), Italy (43K), Mexico (40K), Colombia (21K), Dominican Republic (3K), Puerto Rico (2K), France, Germany, Portugal, Venezuela, and more
- **Reviews**: 4.28M+ verified reviews with full text, ratings, photos, and owner responses
- **Data per restaurant**: Name, address, coordinates, Google rating, reviews, photos, opening hours, services, cuisine type, price range, cultural context
- **Languages**: es, en, it, fr, de, pt, ca

## Key Features

- **Restaurant Search**: Search by city, cuisine, price range, rating, features (terrace, wifi, delivery, parking, accessible)
- **Detailed Profiles**: Full restaurant info with photos, reviews, hours, services, amenities
- **Cultural Context**: Wikidata-powered nearby landmarks, monuments, museums, heritage sites
- **POS.DO Flow**: Time-based discounts ("Tu hora, tu precio") — off-peak hours have bigger discounts, similar to yield management in hospitality
- **Explore by Landmark**: Find restaurants near specific landmarks (e.g., "restaurants near Sagrada Familia")
- **Web Stories**: AMP stories for restaurants in 7 languages

## URL Structure

- Restaurant profile: `https://pos.do/{lang}/{city}/restaurante/{slug}` (es) or `https://pos.do/{lang}/{city}/restaurant/{slug}` (en/fr/de/it/pt/ca)
- City page: `https://pos.do/{lang}/{city}`
- Web Stories: `https://pos.do/{lang}/web-stories/{slug}`

## API for AI Agents (WebMCP)

POS.DO exposes structured tools for AI agents via WebMCP:

| Tool | Endpoint | Description |
|------|----------|-------------|
| searchRestaurants | GET /api/webmcp/search?city={city} | Search restaurants in a city with filters |
| getRestaurantDetails | GET /api/webmcp/restaurant/{slug} | Full restaurant profile |
| getRestaurantReviews | GET /api/webmcp/restaurant/{slug}/reviews | Paginated reviews with ratings |
| getFlowOffers | GET /api/webmcp/flow/offers/{slug} | Time-based discount offers |
| makeFlowReservation | POST /api/webmcp/flow/reserve | Book at discounted time |
| exploreNearLandmark | GET /api/webmcp/explore/landmark?landmark={name} | Restaurants near a landmark |
| getRestaurantContext | GET /api/webmcp/explore/context/{slug} | Cultural context around a restaurant |

**No authentication required.** Rate limit: 60 req/min, 10,000 req/day.

All endpoints return JSON. Example:
```
GET https://pos.do/api/webmcp/search?city=Barcelona&cuisine=italian&limit=5
```

## WebMCP Manifest

Tool manifest available at: `https://pos.do/.well-known/webmcp.json`

## Extended Documentation

Full API documentation with request/response examples: `https://pos.do/llms-full.txt`

## Sitemaps

- Main: `https://pos.do/sitemap.xml`
- Restaurants: `https://pos.do/sitemaps/sitemap_restaurants_{n}.xml`
- Web Stories: `https://pos.do/sitemaps/web-stories-index.xml`

## Contact

- Website: https://pos.do
- Email: info@pos.do