Places

The places tools expose read access to the places domain. There are no mutations here — visits are logged from the web app.

get_place

Full detail for a single place: the place row, tier breakdown across public visits, average ranking score, and up to 12 recent public visits with visitor info and attached photos.

{ "placeId": "plc_..." }

placeId is yumo's internal id (the id column), not a Google place id.

search_places

Case-insensitive substring search against place name. Returns up to 20 matches ordered by public visit count (most-visited first). Results are limited to places with at least one public visit, so this doubles as a "find places the community knows about" query.

{ "query": "noma", "limit": 10 }

limit is optional (1–20, defaults to 12). Each match includes placeId, googlePlaceId, name, city, country, category, primaryImageUrl, and visitCount — so you can feed the placeId directly into get_place or get_place_stats.

get_place_stats

Total public visit count and average ranking score per place, keyed by placeId. Useful for badging tiles in a discover-style grid or comparing a set of places at a glance.

{ "placeIds": ["plc_...", "plc_..."] }

get_ranked_places

A user's ranked places in a single category, ordered best-first within each tier (loved → fine → disliked).

{
  "username": "ryan",
  "category": "food",
  "tier": "loved",
  "limit": 25
}

Only username and category are required. category is one of: food, attraction, hotel, nightlife, shopping, culture, outdoors, other.