Market Data

Price Stats

Retrieve the latest aggregated pricing statistics for a wine in a target region.

post/price_stats

Request

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

Request body

querystring

Free-text wine description. Required when lwin is not provided.

lwinstring

Direct LWIN lookup. Required when query is not provided.

regionstring

Target region alias. Supported values: world, europe, north america, south america, africa, asia, oceania.

currencystring

Optional output currency (uppercased) used for price conversion.

user_idstring uuid required

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

Response

Response highlights:

  • vintage: vintage tied to the returned snapshot.
  • region: normalized region label from the request.
  • lwin: resolved LWIN when present.
  • results[]: array of pricing metrics (created_at, date, median_value, min, p25, p75, max, count, count_outliers, winelabs_price).

Notes:

  • Returns an empty results array when no recent pricing is available for the selected wine and region.
  • Usage limit: up to 150,000 requests per rolling 30 days across Market Data endpoints.
object required

Changes

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