Field Access Matrix
Which fields are returned at each lookup_restaurant tier
Field Access Matrix
The lookup_restaurant tool returns different fields depending on the fields parameter. This page shows exactly which fields are included at each tier.
Basic fields (Free)
Available with fields: "basic" (default). No paid key required.
| Field | Type | Possible values |
|---|---|---|
seemor_id | string | UUID |
name | string | -- |
address | string | null | -- |
coordinates | object | { lat, lng } |
cuisine_tags | string[] | -- |
price_level | string | null | "budget", "moderate", "expensive", "very_expensive", "extremely_expensive" |
grade | string | null | A+ through F (may include ? -- reduced confidence due to low review count or authenticity concerns) |
grade_label | string | "Exceptional", "Excellent", "Very Good", "Mixed Bag", "Think Twice", "Avoid", "" |
tldr | string | null | One-sentence summary |
neighborhood | string | null | -- |
city | string | null | -- |
seemor_url | string | URL to Seemor restaurant page |
coverage_level | string | "full", "basic" |
analysis_date | string | null | ISO date |
Standard fields ($20/1K calls)
Available with fields: "standard". Requires a paid key. Includes all basic fields plus:
| Field | Type | Possible values |
|---|---|---|
summary | string | null | Multi-paragraph analysis |
what_people_love | string[] | Review highlights |
points_of_concern | string[] | Common complaints |
pro_tips | string[] | Insider tips |
ordering_tips | string[] | Menu recommendations |
signature_dishes | string[] | Notable dishes (max 6) |
cost_estimate | object | null | { light_meal, full_meal, with_drinks } -- each string or null (e.g., "$15-20") |
occasions | string[] | LLM-generated (e.g., "Date Night", "Business Lunch") |
dietary | object | null | { vegetarian_options, vegan_options, gluten_free_options } -- integer counts |
Premium fields ($50/1K calls)
Available with fields: "premium". Requires a paid key. Includes all standard fields plus:
| Field | Type | Possible values |
|---|---|---|
dimension_assessments | object | Up to 14 dimension keys, each with { label, sublabel, confidence } |
category_summaries | array | [{ category, badge }] |
value_assessment | object | null | { level, reasoning, value_proposition } |
strengths | string[] | Key strengths (human-readable) |
weaknesses | string[] | Key weaknesses (human-readable) |
unique_selling_points | string[] | Distinctive features (human-readable) |
For the full list of dimension labels, sublabels, and possible values, see the lookup_restaurant reference.
Cost optimization
- Start with basic. Get the grade and TL;DR first. Only upgrade to standard or premium for restaurants the user is interested in.
- Cache results. Restaurant analysis changes infrequently. Cache lookup results for at least an hour.
- Use free tools for filtering.
search_restaurantswithmin_gradepre-filters, so you only spend paid calls on high-quality restaurants.
Light vs. full responses
Note that find_restaurant, search_restaurants, and explore_area (highlights) return a lightweight response with fewer fields than lookup_restaurant basic:
| Field | Light (find/search/explore) | Basic (lookup) |
|---|---|---|
seemor_id, name, address, coordinates | Yes | Yes |
city, neighborhood, cuisine_tags, grade | Yes | Yes |
coverage_level | Yes | Yes |
price_level, grade_label, tldr | No | Yes |
seemor_url, analysis_date | No | Yes |
Use lookup_restaurant to get the full details for any restaurant found via the free search tools.