Seemor API Docs
Tools

explore_area

Neighborhood, city, or region dining intelligence

explore_area

Get a dining overview of a neighborhood, city, or region -- including grade distribution, top cuisines, price breakdown, and highlighted restaurants.

Tier: Free

Use cases

  • Get an overview of dining in an area before narrowing down with search_restaurants
  • Show neighborhood or city dining summaries in your application
  • Understand the culinary landscape of a destination

Parameters

NameTypeRequiredDefaultDescription
areastringYes--Neighborhood, city, or region name. Supports comma disambiguation (e.g., "Shoreditch, London", "Chelsea, NYC").

Response

FieldTypePossible valuesDescription
statusstring"ok", "not_found"Response status
areastring--Resolved area name
descriptionstring | null--Curated description of the area's dining scene (when available)
total_restaurantsnumber--Total restaurants in the area
analyzed_restaurantsnumber--Restaurants with full Seemor analysis
grade_distributionobjectKeys: A+ through F. Values: counts.Grade counts for analyzed restaurants
top_cuisinesarray[{ cuisine, count }] (max 10)Most common cuisines
price_breakdownobjectKeys: "budget", "moderate", "expensive", "very_expensive", "extremely_expensive". Values: counts.Price level distribution
neighborhoodsarray | undefined[{ name, count, top_rated }] (max 10)Only included for city-level queries. top_rated = count of A+/A/A- restaurants.
highlightsarrayLightweight restaurant objects (max 5)Top restaurants by score. Same fields as find_restaurant results.

Example request

curl -X POST https://api.seemor.ai/api/mcp \
  -H "Authorization: Bearer sk_seemor_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "explore_area",
      "arguments": {
        "area": "Shoreditch, London"
      }
    }
  }'

Example response

{
  "status": "ok",
  "area": "Shoreditch",
  "description": "A creative hub in East London with a diverse and evolving dining scene...",
  "total_restaurants": 399,
  "analyzed_restaurants": 285,
  "grade_distribution": { "A+": 2, "A": 8, "A-": 35, "B+": 82, "B": 75, "B-": 40, "C+": 20, "C": 12, "C-": 6, "D": 3, "F": 2 },
  "top_cuisines": [
    { "cuisine": "italian", "count": 45 },
    { "cuisine": "indian", "count": 32 },
    { "cuisine": "japanese", "count": 28 }
  ],
  "price_breakdown": { "budget": 45, "moderate": 150, "expensive": 70, "very_expensive": 20 },
  "highlights": [
    {
      "seemor_id": "...",
      "name": "Leroy",
      "grade": "A",
      "cuisine_tags": ["modern european", "wine bar"],
      "coverage_level": "full"
    }
  ]
}

Notes

  • The neighborhoods array is only populated for city-level queries, not neighborhood-level.
  • If an area isn't recognized, the response returns status: "not_found" with a message. This is not billed.
  • highlights uses the same lightweight format as find_restaurant results (no grade_label, tldr, or seemor_url).

On this page