Market Data

Historical Price Stats

Retrieve the historical time series of aggregated pricing statistics for a wine — one row per date (roughly the last 14 months) instead of the single latest snapshot returned by /price_stats.

post/historical_price_stats

Request

  • Base URL: https://external-api.wine-labs.com
  • URL: https://external-api.wine-labs.com/historical_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 series.
  • region: normalized region label from the request.
  • lwin: resolved LWIN when present.
  • results[]: time series ordered by date — one entry per date (created_at, date, median_value, average, min, p25, p75, max, count, count_outliers, winelabs_price), covering roughly the last 14 months.

Notes:

  • Same request shape as /price_stats; /price_stats returns the latest snapshot while /historical_price_stats returns the full dated history.
  • Returns an empty results array when no historical 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.