beyond-wine

Find published claims with their source provenance. To answer about a specific drink or producer, supply BOTH entity_type and its exact returned entity_slug. For a sourced statement, these two filters are normally sufficient: omit claim_type and reliability_class unless needed. claim_type is a record format (atomic_fact, structured_fact, editorial_claim), not a topic such as ingredients or collaboration. Inspect provenance.sources and describe producer statements, interviews, and independent reporting with their actual attribution. Follow meta.has_more pagination before making negative findings about the queried records and filters. Limit those findings to sources actually inspected; completing pagination does not establish that evidence is absent elsewhere. Preserve the source's exact alcohol wording. 0% and 0.0% are different wording, but that difference does not by itself establish different measured trace-alcohol thresholds. 'Below 0.5%' is an upper-bound declaration; these declarations do not by themselves prove measurement or laboratory testing. Do not infer that alcohol is absent from ingredients or production methods.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant"
      ]
    },
    "entity_slug": {
      "type": "string",
      "minLength": 1
    },
    "claim_type": {
      "type": "string",
      "enum": [
        "atomic_fact",
        "structured_fact",
        "editorial_claim"
      ]
    },
    "reliability_class": {
      "type": "string",
      "enum": [
        "primary",
        "secondary",
        "tertiary",
        "editorial"
      ]
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve a published claim with provenance.sources and version history. Copy claim_uid from a profile or claim search. Use this to check a source behind a profile claim preview; cite an actual returned source or citation_url and preserve its source attribution. One claim does not establish that no other records or sources exist. Preserve the source's exact alcohol wording. 0% and 0.0% are different wording, but that difference does not by itself establish different measured trace-alcohol thresholds. 'Below 0.5%' is an upper-bound declaration; these declarations do not by themselves prove measurement or laboratory testing. Do not infer that alcohol is absent from ingredients or production methods.

{
  "type": "object",
  "properties": {
    "claim_uid": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "claim_uid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find producers by name, country, city, ingredient or technique. This searches producers, not beverage names: use search_beverages for a drink. If empty, try a shorter producer name or remove extra filters. Copy the exact returned slug into get_producer, whose data.beverages contains the lineup.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1
    },
    "country": {
      "type": "string",
      "minLength": 1
    },
    "region": {
      "type": "string",
      "minLength": 1
    },
    "city": {
      "type": "string",
      "minLength": 1
    },
    "ingredient": {
      "type": "string",
      "minLength": 1
    },
    "technique": {
      "type": "string",
      "minLength": 1
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve a specific producer documented by Beyond Wine, such as MURI or AMA Brewery. Includes the producer's published beverage lineup under data.beverages. Use search_producers first when the producer slug is unknown.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1
    },
    "condensed": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find a beverage by name or alias. Start here for drink names, not search_producers. q matches a beverage name, alias OR producer name; a combined producer-plus-product phrase may not match. If empty, try a distinctive product word or search the producer separately and inspect its lineup. Use producer with an exact producer slug to list its drinks. Verify the returned beverage name and producer, copy its exact slug into get_beverage, then get_claim for source provenance. Do not infer nonexistence from an empty search or silently substitute another product.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 1
    },
    "category": {
      "type": "string",
      "minLength": 1
    },
    "producer": {
      "type": "string",
      "minLength": 1
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve a published beverage profile and claim previews. Find the exact slug with search_beverages; never invent it. Check the returned producer against the question. To provide a sourced fact, call get_claim on a returned claim_uid, or search_claims with entity_type=beverage and this slug. Profile previews alone do not contain source lists. Cite an actual returned source or claim URL.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1
    },
    "condensed": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve a published entity profile with structured data and claim previews. For source provenance, follow a returned claim_uid with get_claim; cite actual returned source or claim URLs. Profiled entities (producers, beverages, people, restaurants) are independent businesses documented by Beyond Wine, not brands of it.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant",
        "ingredient",
        "technique",
        "prepared_ingredient"
      ]
    },
    "slug": {
      "type": "string",
      "minLength": 1
    },
    "condensed": {
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "entity_type",
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List published entity profiles in the Beyond Wine knowledge base by type.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant",
        "ingredient",
        "technique",
        "prepared_ingredient"
      ]
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "entity_type"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve a token-bounded context bundle for a Beyond Wine topic, including entity summary and optional claims or graph data.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "minLength": 1
    },
    "max_tokens": {
      "default": 4000,
      "type": "integer",
      "minimum": 100,
      "maximum": 8000
    },
    "include": {
      "default": [
        "entity",
        "claims"
      ],
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "entity",
          "claims",
          "graph"
        ]
      }
    }
  },
  "required": [
    "topic"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve direct relationship neighbors for an entity profiled in the Beyond Wine knowledge base.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "producer",
        "beverage",
        "person",
        "restaurant",
        "prepared_ingredient"
      ]
    },
    "slug": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "entity_type",
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Retrieve the Beyond Wine ontology, entity types, relationship types, and semantic scales.

{
  "type": "object",
  "properties": {
    "format": {
      "default": "json",
      "type": "string",
      "enum": [
        "json",
        "json-schema"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}