{"openapi":"3.1.0","info":{"title":"Husfarm API","version":"1.0","description":"Free read-only wholesale food and agricultural price data. Static JSON files, regenerated after every data update (data of 2026-11-17). No key needed; please poll at most every 15 minutes and credit Husfarm.","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"url":"https://husfarm.com/contact/"}},"servers":[{"url":"https://husfarm.com/v1"}],"externalDocs":{"url":"https://husfarm.com/api/"},"paths":{"/index.json":{"get":{"summary":"List of endpoints, data date, licence and counts","operationId":"index_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/quotes.json":{"get":{"summary":"All current quotes with price per kg in EUR, previous quote, data notes and source","operationId":"quotes_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteList"}}}},"404":{"description":"Unknown market, product or index"}}}},"/products/{product}.json":{"get":{"summary":"Current quotes of one product in all markets","operationId":"products_product_json","parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Product slug (see products.json)"}],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteList"}}}},"404":{"description":"Unknown market, product or index"}}}},"/markets/{market}.json":{"get":{"summary":"Current quotes of one market","operationId":"markets_market_json","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Market slug, as in /markets/{market}/ on husfarm.com (see markets.json)"}],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteList"}}}},"404":{"description":"Unknown market, product or index"}}}},"/markets/{market}/history.json":{"get":{"summary":"Full price history of every series of one market: [date, min, max]","operationId":"markets_market_history_json","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Market slug, as in /markets/{market}/ on husfarm.com (see markets.json)"}],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/markets.json":{"get":{"summary":"All markets with country, type, coordinates, number of quotes and latest quote date","operationId":"markets_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/products.json":{"get":{"summary":"Product dictionary with groups, types and the number of current quotes","operationId":"products_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/indices.json":{"get":{"summary":"All Husfarm indices: median price in EUR/kg, latest change, monthly changes","operationId":"indices_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/indices/{index}.json":{"get":{"summary":"One index with monthly history, constituents and medians by country; indices/husfarm.json is the weekly Husfarm Index","operationId":"indices_index_json","parameters":[{"name":"index","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Index slug (see indices.json)"}],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/forecasts.json":{"get":{"summary":"Price forecasts: list of products and markets with forecasts, test results and the record of issued forecasts","operationId":"forecasts_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/forecasts/{market}.json":{"get":{"summary":"Price forecasts of one market: 1 to 12 weeks ahead with 80% ranges, typical errors and the last 52 weekly averages","operationId":"forecasts_market_json","parameters":[{"name":"market","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]+$"},"description":"Market slug, as in /markets/{market}/ on husfarm.com (see markets.json)"}],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/fx.json":{"get":{"summary":"Exchange rates used for the conversion to EUR, with source and date","operationId":"fx_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/releases.json":{"get":{"summary":"Log of the latest 100 data releases","operationId":"releases_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}},"/openapi.json":{"get":{"summary":"This API described in OpenAPI 3.1","operationId":"openapi_json","parameters":[],"responses":{"200":{"description":"JSON document","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown market, product or index"}}}}},"components":{"schemas":{"Quote":{"type":"object","properties":{"key":{"type":"string","description":"market/quote, also the page address /prices/quotes/{key}/"},"market":{"type":"string"},"quote":{"type":"string"},"name":{"type":"string","description":"Quote name as published by the market"},"product":{"type":["string","null"]},"type":{"type":["string","null"]},"group":{"type":["string","null"]},"country":{"type":["string","null"]},"date":{"type":"string","format":"date"},"min":{"type":"number"},"max":{"type":"number"},"currency":{"type":"string"},"unit":{"type":"string"},"kg_per_unit":{"type":["number","null"]},"eur_per_kg":{"type":["number","null"],"description":"Mid-point in EUR per kg at the rate of fx_date"},"previous":{"type":["object","null"]},"notes":{"type":"array","items":{"type":"string"}},"source":{"type":["string","null"],"format":"uri"},"url":{"type":"string","format":"uri"}}},"QuoteList":{"type":"object","properties":{"as_of":{"type":"string","format":"date"},"fx_date":{"type":"string","format":"date"},"license":{"type":"string"},"count":{"type":"integer"},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}}}}}}}