Market Insights

Price History

Return aggregated price history for a resolved wine with client-friendly caching and currency conversion.

post/price_history

Request

  • Base URL: https://external-api.wine-labs.com
  • URL: https://external-api.wine-labs.com/price_history
  • 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.

user_idstring uuid required

Authorized user identifier (accepts user_id or userId) required for market_insights access.

regionstring

Region alias. Supported values: world, europe, north america, south america, africa, asia, oceania, uk, united kingdom, continental europe.

vintagestring

Vintage filter; use ALL to include every vintage.

currencystring

Output currency (uppercased) for price conversion.

start_datestring

Inclusive start date filter; rejected when the format is invalid or if it is later than end_date.

end_datestring

Inclusive end date filter; validated against start_date and forwarded to the SQL query.

limitnumber

Rows per page (clamped 1–2000), ordered by newest date first.

offsetnumber

Pagination offset (>= 0).

Response

Response highlights:

  • history[]: reverse-chronological price history data with converted prices.
  • regions: static list of available region aliases for selection.

Notes:

  • Requires market_insights authorization plus either query or lwin; unresolved wines return 404.
  • start_date/end_date are parsed and logged with the request metadata, and rejected when invalid or when start_date is later than end_date.
object required

Changes

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