POST /v1/search

Every returned restaurant includes vegan_dining.menu: all food dishes, stored prices and ingredients, without drinks or descriptions. No option is required. Search accepts at most 10 restaurants per request. Credits stay unchanged. Google-labeled menus return an empty menu with null counts and excluded: "source_not_permitted".

Ingredients as printed on the restaurant's menu, when listed. May be incomplete. Not for allergy decisions.

Menus deduplicate by normalized dish name. The first stored food row supplies display fields. Original sections are grouped with main courses first; other sections retain stored order, and unknown sections come last. False is_vegan includes unconfirmed classifications. Menus are never truncated: JSON responses above 250 KB return 413 full_menu_too_large; streaming Search emits an error event with status 413. Reduce the Search limit or retrieve restaurants individually.

Search and Enrich return complete food menus with stored prices and ingredients. Matching dish lists remain request-specific.

SearchResponse: 204 contract leaves. A row is one contract leaf. Optional leaves, missing restaurant evidence, and fast mode can omit fields. This count is the schema, not a promise that every response contains every field.

The example answers the ramen request above. Each result is a restaurant with its matching vegan dishes and the date the menu was collected. A ramen request returns ramen dishes only.

Abridged SearchResponse example — 31 of 204 contract leaves. Illustrative values, not a live payload.

{
  "compass_request_id": "req_example_quickstart",
  "coverage": {
    "status": "in_coverage",
    "covered_geography": "US"
  },
  "results": [
    {
      "compass_id": "cmp_example_ramen_house_001",
      "name": "Example Ramen House",
      "dish_match": {
        "requested_dish": "ramen",
        "match_type": "dish",
        "dishes": [
          {
            "name": "Shoyu Vegan Ramen",
            "category": "Pasta & Noodles",
            "match_type": "variant",
            "is_vegan": true
          },
          {
            "name": "Spicy Miso Vegan Ramen",
            "category": "Pasta & Noodles",
            "match_type": "variant",
            "is_vegan": true
          }
        ]
      },
      "vegan_dining": {
        "dishes_availability": "yes",
        "vegan_dish_count": 6,
        "matching_dish_count": 2,
        "matched_dishes": [
          {
            "name": "Shoyu Vegan Ramen",
            "category": "Pasta & Noodles",
            "match_type": "variant",
            "evidence_id": "ev_dish_example_shoyu_vegan_ramen",
            "vegan_basis": "validated_menu_classification"
          },
          {
            "name": "Spicy Miso Vegan Ramen",
            "category": "Pasta & Noodles",
            "match_type": "variant",
            "evidence_id": "ev_dish_example_spicy_miso_vegan_ramen",
            "vegan_basis": "validated_menu_classification"
          }
        ],
        "truncated": false,
        "menu_collected_at": "2026-10-07T16:00:00Z",
        "menu_collected_at_status": "known",
        "match_status": "matched"
      },
      "match_for_profile": {
        "decision": "fit",
        "confidence": "medium",
        "reason_codes": [
          "REQUESTED_DISH_AVAILABLE"
        ],
        "risk_flags": [],
        "verification_required": true,
        "recommended_user_text": "Compass found a vegan version of the requested dish on the collected menu (menu collected 2026-10-07)."
      }
    }
  ],
  "result_status": "matched",
  "total_results": 1,
  "ai_generated": true
}

Fast mode keeps the same v5 score components and omits query_interpretation. It keeps at most two evidence items and three match_for_profile reason codes. Those limits are marked on the generated response rows above.