ELID API

POST /api/v1/match

Match wine text against this site’s snapshot.

curl 'https://elid.wine/api/v1/match' \
  -H "Content-Type: application/json" \
  -d '{"raw":"Kanonkop Paul Sauer 2021","top_n":3}'

Returns ranked data with elid, lwin, lwins, display_name, producer_name, wine, score, producer_score and name_score. Scores rank candidates; they are not probabilities. A top score of 0.75 or more is a confident match; 0.50 means the text names no single wine (a producer alone, or a tie such as red and white). No accepted match returns [].

snapshot identifies the data version; matcher_version identifies the scorer. Matching returns base wine identities. Retrieve vintage facts with the wine endpoint below.

GET /api/v1/wines

Active wine identities, ordered by ELID.

Response structure · selected fields

{
  "data": [
    {
      "elid": "AR-MDZ-CTZP01",
      "display_name": "Nicolás Catena Zapata",
      "lwin": null
    }
  ],
  "next_cursor": "AR-MDZ-CTZP01"
}

next_cursor: null marks the last page.

GET /api/v1/wines/{elid}

One wine’s catalog fields and available vintage facts. Use the base ELID without a vintage suffix.

curl 'https://elid.wine/api/v1/wines/AR-MDZ-CTZP01'

The data object includes a facts array, ordered by vintage descending. No facts: []. Vintage is a year string or NVXX.

LWIN lookup

Query /api/v1/wines?lwin=1831339 to find its ELID. Wine records include lwins with all known seven-digit wine-level identifiers. lwin is the primary value, or the sole known alias when there is exactly one; it is null when none or multiple aliases are known. Reviewed historical aliases also resolve through the lookup.