Matching

Match To LWIN

Resolve a single wine search query to LWIN codes, a Wine Labs ID and a normalized display label.

post/match_to_lwin

Request

  • Base URL: https://external-api.wine-labs.com
  • URL: https://external-api.wine-labs.com/match_to_lwin
  • Auth: none declared

Request body

user_idstring uuid required

Account identifier issued during onboarding; used for authentication and quota tracking.

querystring

Wine name, producer, vintage, or other descriptive text to resolve. Required when lwin and wl_id are not provided.

lwinstring

Direct LWIN lookup. Required when query and wl_id are not provided.

wl_idstring

Wine Labs wine identifier. Required when query and lwin are not provided.

Response

Response highlights:

  • lwin7: base 7-digit LWIN code when a match is found.
  • lwin: longest available LWIN including vintage or format detail.
  • display_name: normalized wine name suitable for customer-facing views.
  • wl_id: the Wine Labs ID, the canonical identifier covering 813K+ wines and spirits.

Notes:

  • Returns null values for all fields when the query cannot be matched.
  • Usage limit: up to 30,000 matched rows per rolling 30 days across matching endpoints.
object required

Changes

No recorded changes to this operation across all 1 revision of this API.