com.proofprice/pricepaid

Est-ce que com.proofprice/pricepaid est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.proofprice/pricepaid » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 30 outils

• pricepaid_airfare_prices≈ 2507 tokens

  Use this when a user asks what people actually pay for a flight between two cities or airports (for example JFK to LAX, or Chicago to Miami), or what the average airfare out of a city is, in Australia (domestic routes) (country AU) or the United States (domestic flights within the contiguous 48 states) (country US). Returns the official average fare per passenger each way, in the currency the answer states, for the latest quarter published, with (where the source publishes them) the passengers per day behind it, the share of the largest carrier, the change on a year earlier and the last few quarters, plus the official source and licence. This is a published quarterly average of fares paid (price_type official_statistic), not a range built from tickets, so the range fields are null and there is no sample size; how fresh: Australia (domestic routes): monthly; the newest month is usually the one just ended; the United States (domestic flights within the contiguous 48 states): quarterly, published about five to six months after the quarter ends (the first quarter of 2026 was published in September 2026); every answer states its quarter. Do not use for today's fare, a specific date, airline or cabin, a booking or price alert, international flights, routes outside the places named above, hotels, or other countries.

  Paramètres, retour & exemple (4)

  Paramètres

  • to · string · optionnel
    Where it ends: an airport code or a city. Leave out to get the average fare over the busiest routes out of the 'from' city. AU: city or airport code. Required for AU (the answer is for one route, either direction). US: airport code or city. Two airports give the airport-pair average where DOT publishes it; otherwise (and for cities) the city-pair average.
  • from · string · requis
    Where the flight starts: an airport code (JFK, LAX) or a city (Chicago, 'Portland, OR'). Required. AU: city or airport code (Sydney, SYD, 'Gold Coast', OOL). Required, and AU also needs 'to'. US: airport code (JFK, ORD) or city ('Chicago', 'Portland, OR', 'New York'). Airports in one metro area share one city market for city-level questions.
  • country · string · requis · AU | US
    AU = Australia (domestic routes between about 70 city pairs; cheapest advertised return fare, not a fare paid); US = United States, contiguous 48 states (domestic flights only; Alaska, Hawaii and territories are not covered)
  • quarters · integer · optionnel
    How many recent quarters to include in the trend (default 4, at most 20). The headline figure is always the latest quarter. AU: the range covers this many quarters of monthly fares (default 4 = 12 months; at least 2 are needed for a range). AU publishes one cheapest advertised return fare per route per month: advertised, not paid, so the price type is posted_price. US: the trend lists this many quarters, newest first. DOT publishes about five to six months after a quarter ends.

  Exemple d'appel

  {"name": "pricepaid_airfare_prices", "arguments": {"from": "texte", "country": "AU"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_broadband_prices≈ 2344 tokens

  Use this when a user asks what home internet (fixed broadband at a given speed, with or without phone and TV) or a mobile data plan costs per month in the EU, or how that compares between countries. Returns the official figure for a standard offer in the latest year published, the previous year and the change, and the same country's other offers, with the official source and licence. It is the cheapest posted offer of the largest operators, not what customers actually paid, and not a range built from sales: the range fields are null and there is no sample size. How fresh: annual figures with a lag of about two years (newest year 2024, dataset updated May 2026); each answer states its reference year. Do not use for a quote from one provider, for business lines, or for countries that are not listed.

  Paramètres, retour & exemple (2)

  Paramètres

  • offer · string · optionnel
    Which standard offer. Friendly names such as fixed_100_200 (fixed internet 100-200 Mbps, the default), fixed_30_100, fixed_1gbps, mobile_10gb, mobile_unlimited, or a publisher code. The country notes list them. EU, Eurostat: the cheapest posted offer of the largest operators, PPP euro per month. Names: fixed_lt12 (FI_MBPS_LT12), fixed_30_100 (FI_MBPS30-100), fixed_100_200 (FI_MBPS100-200), fixed_200_999 (FI_MBPS200-999), fixed_1gbps (FI_GBPS_GE1), fixed_100_200_phone (FI_MBPS100-200_P), fixed_100_200_phone_tv (FI_MBPS100-200_PTV), mobile_1gb (MI_GB1_NC), mobile_2gb (MI_GB2_NC), mobile_5gb (MI_GB5_NC), mobile_10gb (MI_GB10_NC), mobile_20gb (MI_GB20_NC), mobile_50gb (MI_GB50_NC), mobile_unlimited (MI_NLTD_NC). Any Eurostat offer code also works, e.g. FI_MBPS30-100_PTV (fixed 30-100 Mbps with phone and TV). Default fixed_100_200.
  • country · string · requis · AT | BE | BG | HR | CY | CZ | DK | EE
    EU member states as ISO codes (GR for Greece): AT = Austria, BE = Belgium, BG = Bulgaria, HR = Croatia, CY = Cyprus, CZ = Czechia, DK = Denmark, EE = Estonia, FI = Finland, FR = France, DE = Germany, GR = Greece, HU = Hungary, IE = Ireland, IT = Italy, LV = Latvia, LT = Lithuania, LU = Luxembourg, MT = Malta, NL = Netherlands, PL = Poland, PT = Portugal, RO = Romania, SK = Slovakia, SI = Slovenia, ES = Spain, SE = Sweden

  Exemple d'appel

  {"name": "pricepaid_broadband_prices", "arguments": {"country": "AT"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_car_prices≈ 2044 tokens

  Use this when a user asks what people actually paid for the right to own or buy a car (an entitlement or quota certificate, a sale or an auction result) in Singapore car ownership rights (COE) (country SG). Returns the median winning price, a typical range (10th–90th percentile), the number of bidding rounds or sales, the period covered, a confidence label, and the official source and licence. Do not use for asking prices, dealer listings, or other countries.

  Paramètres, retour & exemple (4)

  Paramètres

  • months · integer · optionnel
    How many recent months to include. Default 12.
  • country · string · requis · SG
    SG = Singapore COE (Certificate of Entitlement) bidding results
  • product · string · optionnel · coe
    Which price. 'coe' = Certificate of Entitlement bidding results (the country notes say where it exists). Default 'coe'. SG: 'coe'.
  • vehicle_class · string · optionnel · A | B | C | D | E
    SG only: COE category. A = cars up to 1600cc (default), B = cars above 1600cc, C = goods vehicles/buses, D = motorcycles, E = open.

  Exemple d'appel

  {"name": "pricepaid_car_prices", "arguments": {"country": "SG"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_check_price≈ 9306 tokens

  Use this before paying: when a user or agent has a proposed price for something (a rent, a home, a litre of fuel, a medicine, a contract) and wants to know whether it is typical against recorded official evidence. Give the category (broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-fresh-food, wholesale-markets and wholesale-power), the country, the same parameters that category's own tool takes, and the price. It runs the category's normal answer and returns a verdict: within, above or below the typical range (10th–90th percentile of recorded prices) when the evidence is a set of records; about, above or below the average when the evidence is one official average or median (within 5% counts as about average, and it says plainly this is an average, not a distribution); or cannot_judge, with the reason, when the currency or unit differs (ProofPrice never converts), there are too few records or nothing matched. It also returns where the price sits (for example '27% above the median and above the 90th percentile'), the reasons and cautions (posted prices are not paid prices, old periods), what is missing, one quotable sentence, and the full evidence answer with source, licence and audit-trail fields to keep with the reasoning. Do not use it to value one specific item or address, as financial or legal advice, or to compare prices in different currencies or units. After 20 free calls a day per caller this tool costs USD 0.10 per answered call, paid with x402 (USDC); a 402 reply lists how. Nothing is charged for "not enough records" or errors.

  Paramètres, retour & exemple (62)

  Paramètres

  • to · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). flights: Where it ends: an airport code or a city. Leave out to get the average fare over the busiest routes out of the 'from' city. AU: city or airport code. Required for AU (the answer is for one route, eith
  • cpv · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). contracts: Optional official product code, to be exact, where the source uses one (the country notes say which code system), e.g. the CPV code 30213100 for portable computers; a prefix such as 3021 covers the wh
  • area · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). childcare: Place: a county, a region, a local authority, or a state or city where the source says so (examples: 'Cook County, IL', 'London', 'Dublin'). Leave out for the whole country, where the source has a nat | construction: State or region, where the publisher splits by place (the country notes say how). Leave out for the national figure. BR: state name or two-letter code ('São Paulo', 'SP', 'Bahia', 'RJ'); leave out for | fuel: Wider area when no postcode. BR: state as a two-letter code or name ('SP', 'Minas Gerais'); leave empty for all Brazil. Canada: same as town (a city, or 'Canada'). Provinces are not published. ES: pro | home-upgrades: Place, only where the publisher splits by place (the country notes say how). Leave out for the national figure. GB: national figures only; an area is ignored and the answer says so. IE: a county (Kerr | hotels: Region, province or city inside the country, in plain words (for example 'Madrid', 'Andalucia', 'Benidorm'). Leave out for the national average. ES: optional. A region ('Andalucia', 'Cataluña', 'Madri | insurance: Place: a 5-digit ZIP code or a state code, depending on the country notes (examples: '32935', 'TX'). Required. US: required. A 5-digit ZIP code ('32935') or a 2-letter state or territory code ('TX', '
  • from · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). flights: Where the flight starts: an airport code (JFK, LAX) or a city (Chicago, 'Portland, OR'). Required. AU: city or airport code (Sydney, SYD, 'Gold Coast', OOL). Required, and AU also needs 'to'. US: airp
  • fuel · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). fuel: petrol95 = unleaded 95; methane = CNG (priced per kg). Brazil: petrol95 = regular petrol (gasolina comum, not RON 95) or diesel (= diesel S10). Other fuels are not covered. Canada: petrol95 = regular
  • item · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). groceries: Everyday item in plain words, e.g. 'milk', 'white bread', 'eggs', 'butter', 'coffee', 'bananas', 'beer'. Each country measures its own standard pack or cut; the answer names it and lists other definit
  • town · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). commercial-property: Town or city. FR: town, e.g. 'Bordeaux', or use postcode. | fuel: Town name. BR: municipality, e.g. 'São Paulo' or 'Curitiba'; add area when the name exists in several states. Canada: one of the 18 cities Statistics Canada tracks (St. John's, Charlottetown and Summe | home-sales: Town or city. AT: a municipality among the 100 largest ('Wien' / 'Vienna', 'Graz', 'Linz', 'Salzburg', 'Innsbruck'), a district ('Wien 2' for Leopoldstadt, 'Bezirk Baden', 'Kitzbühel'), or a Bundeslan | rent: Town, city or local area. AU: use 'NSW' for the whole state; otherwise give a postcode (NSW rents are published by postcode). CA: required. A town or city of 10,000 people or more, e.g. Toronto, Montr
  • unit · string · optionnel
    What the price is per, for example 'per month', 'per litre', 'per home'. Defaults to the evidence unit. A different unit gives cannot_judge.
  • what · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). contracts: What was bought, in plain words: 'laptops', 'school meals', 'road resurfacing', 'office cleaning', 'electricity', 'ambulances', 'waste collection'. Common purchases are matched to official product cod
  • year · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). diet-costs: Year of the estimate (2017 onwards). Leave out for the newest year the World Bank holds. World Bank: 2017 to the newest year held (2025 at the last check). Leave out for the newest year.
  • zone · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). wholesale-power: Bidding zone, only where a country has more than one: DK = DK1 (west, default) or DK2 (east). IT answers northern Italy (IT-North), NO south-west Norway (NO2); other countries have one zone.
  • cycle · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). tuition: Degree level: first = bachelor's (first cycle, the default), second = master's (second cycle). Also accepts bachelor, master, undergraduate, postgraduate. Canada, Statistics Canada: first = undergradu
  • hours · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). childcare: Full-time or part-time care, where a source publishes both. Most sources publish one basis only and say which. GB: ignored; fees are per hour, with no full-time or part-time split. IE: ignored; the ta
  • offer · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). broadband: Which standard offer. Friendly names such as fixed_100_200 (fixed internet 100-200 Mbps, the default), fixed_30_100, fixed_1gbps, mobile_10gb, mobile_unlimited, or a publisher code. The country notes
  • price · number · requis
    The price to check, as a number above zero (for example 2400 or 1.95), in the unit and currency below.
  • rooms · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). rent: NO only: number of rooms (living rooms plus bedrooms), 1 to 5 (5 means five or more). Required for Norway.
  • spend · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). price-levels: What kind of spending: leave out for all household consumption, or give 'food', 'meat', 'dairy', 'bread and cereals', 'fruit', 'vegetables', 'alcohol', 'tobacco', 'clothing', 'housing' (rent, water, e
  • stars · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). hotels: Hotel star category (1 to 5), for sources that publish it. Only national figures are split by stars; do not combine with area. ES: optional, 1 to 5 hotel stars. INE publishes star categories for Spain
  • state · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). energy: US only: the state, by name or postal code ('Texas', 'TX', 'DC'). Leave out for the U.S. average. Gas: EIA publishes no figure for a few states in recent months, then the newest published month is ret | home-sales: US only: 'CT' (Connecticut), 'NY' (New York City) or 'IL' (Cook County). Usually inferred from the place; set it when a name exists in two of them. | medical: A state or territory, where the source publishes one (the country notes say how to write it). Leave out for the national average. Singapore: the ward class, because Singapore has no states: c = public
  • taxes · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). energy: Tax level of the price. 'all' = all taxes and levies included (what a household pays, default); 'excl_vat' = excluding VAT and other recoverable taxes; 'none' = excluding all taxes and levies. BR: not
  • county · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). home-sales: IE only: same as town; a county such as 'Dublin' or 'Cork'.
  • energy · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). energy: electricity or gas (natural gas). BR: electricity only (no gas). The figure is the regulated residential tariff (TE energy + TUSD network) before taxes and flag surcharges, as a posted price. EU/NO/IS
  • market · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). wholesale-markets: One wholesale market, only where the source publishes by market (for example a city name). Leave out for all markets together. TW: optional wholesale market: taipei, banqiao, sanchong, yilan, taoyuan, | wholesale-power: Which wholesale market. Only day-ahead (the next-day hourly auction) is available. DE: day-ahead only (the hourly auction held the day before delivery). AT/BE/DK/FR/IT/NL/NO/PL: day-ahead only (the au
  • months · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). cars: How many recent months to include. Default 12. | commercial-property: How many recent months to include. Default 24. | contracts: How many recent months of awards to include. Default 24. EU and EEA: up to 60; only the newest 1,000 matching notices are read, so a very common purchase covers a shorter period than asked (the answer | home-sales: How many recent months to include. Default 12. AT: ignored; STATISTIK AUSTRIA publishes one figure per calendar year (the latest is returned). AU: not used; the ABS publishes one mean price per quarte | rent: How many recent months to include, for sources that hold individual rents. Ignored by sources that publish one figure per quarter or month. AU: 3 or 12 (anything up to 4 uses the latest 3 months, long
  • region · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). energy: NZ only: electricity network region, for example 'Auckland', 'Wellington', 'Christchurch', 'Dunedin'. Leave out for the unweighted median across all regions. | farm-gate-prices: Region inside the country, as the statistics office publishes it (for example a province or state). Some countries publish no national figure, so the answer then asks for a region. Canada: a province | groceries: Region inside the country, only where the statistics office publishes regional averages. Leave out for the national average. Canada: leave out for the Canada average, or give a province (Ontario, BC, | land-prices: Optional region code for a regional figure, where the source publishes one (the country notes say which codes). Leave out for the whole country. EU/NO, optional. A NUTS region code (Eurostat's regiona
  • country · string · requis
    ISO country code of the place (for example IE, GB, FR). Which countries a category covers: see pricepaid_coverage.
  • measure · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). home-upgrades: The upgrade: heat_pump, solar_pv, attic_insulation, wall_insulation, windows, or renovation (any home renovation works, where the publisher does not split by type). Plain words such as 'heat pump' or | land-prices: price = what agricultural land sells for per hectare; rent = what it costs to rent per hectare for one year. EU/NO: price = average sale price of agricultural land per hectare (Eurostat apri_lprc); re
  • product · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). cars: Which price. 'coe' = Certificate of Entitlement bidding results (the country notes say where it exists). Default 'coe'. SG: 'coe'. | farm-gate-prices: The crop or animal product, e.g. 'wheat', 'barley', 'oats', 'canola', 'soybeans', 'corn', 'potatoes', 'cattle', 'hogs', 'lambs', 'chickens', 'milk', 'eggs'. The full list is in the tool notes. Canada: | farm-prices: The product, e.g. 'wheat', 'barley', 'beef', 'pig', 'lamb', 'chicken', 'eggs', 'milk', 'butter', 'olive oil', 'tomatoes', 'apples'. The full list is in the tool notes. EU: required. The product, by na | producer-prices: The crop or animal product, e.g. 'wheat', 'maize', 'rice', 'soybeans', 'potatoes', 'tomatoes', 'apples', 'bananas', 'beef', 'pork', 'chicken', 'eggs', 'milk', 'coffee', 'cotton'. US, CA, BR, MX, AU, N | wholesale-fresh-food: The food in plain words, e.g. 'live pig', 'chicken', 'eggs', 'grass carp', 'tomato'. The list for each country is in the tool notes. GB: home-grown fruit and vegetables: apples (gala, bramley, cox...) | wholesale-markets: The vegetable or fruit in plain words, e.g. 'cabbage', 'tomato', 'banana', 'pineapple'. The local-language name also works. The full list is in the tool notes. TW: required. Vegetable or fruit by Engl
  • service · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). fuel: Self-service or attended service, where a country prices them differently. Canada: self only. Full-service prices stopped in 2013. EU Weekly Oil Bulletin countries: not used. GB: not used. IT: self-se | medical: The medical service: plain words ('office visit', 'MRI lower back', 'knee replacement'), a billing code or a hospital-stay group code, as the country notes list them. Required. Singapore: a medical co
  • setting · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). medical: office = a doctor's office (whole service); facility = hospital outpatient or surgery centre (doctor's fee only); inpatient = a hospital stay. Leave out to use the usual setting for the service. Singa
  • size_kw · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). home-upgrades: GB solar_pv: system size in kW; picks the DESNZ size band (0-4, 4-10 or 10-50 kW). Default: the 0-4 kW band.
  • tenancy · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). rent: FR only: all leases (default), new = leases signed in the last year (what a new tenant faces), existing = leases of one year or more. New leases are published per dwelling type, not per size.
  • bedrooms · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). rent: Number of bedrooms (0 = studio). Leave out for all sizes. AU: 0 (studio), 1, 2, 3 or 4 (4 means four or more). CA: 0 (bachelor), 1, 2 or 3 (three or more). Leave out for two bedrooms, CMHC's usual hea
  • category · string · requis
    Which kind of price: broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-fresh-food, wholesale-markets and wholesale-power (the REST path or the tool name also works).
  • currency · string · optionnel
    ISO 4217 currency code of the price (for example EUR). Defaults to the evidence currency. A different currency gives cannot_judge: ProofPrice never converts.
  • includes · string · optionnel
    What the price includes or excludes, as free text (for example 'VAT included, delivery excluded'). Echoed back as a caution; it is not used to adjust the figure.
  • medicine · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). medicines: Medicine brand or active-substance name, e.g. 'doliprane' or 'paracetamol'. Only the first word is used. ES: Spanish active-ingredient or brand name, first word used ('paracetamol', 'ibuprofeno', 'ome
  • postcode · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). commercial-property: Postcode, for a precise area. FR: 5-digit postcode, e.g. '33000'; use instead of town for a precise area. | fuel: Postcode of the place. BR: not used (the survey is published by state and municipality). Canada: not used. ES: 5-digit postcode, e.g. '28001'. EU Weekly Oil Bulletin countries: not used; the bulletin | home-sales: Postcode, for a precise area. AT: only Vienna postcodes (1010 to 1230) are matched, to the Vienna district; elsewhere give the town or district as town. AU: a 4-digit postcode ('2150'), answered with | rent: Postcode, for a precise area. AU: a four-digit NSW postcode, e.g. 2000 (Sydney CBD), 2150 (Parramatta), 2500 (Wollongong). CA: not used; give a town. ES: not used. FR: not used; give the agglomeration
  • province · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). tuition: Canada only: a province (Ontario, Quebec, BC, Alberta ...) or leave out for the Canada average. Yukon is mostly not published; the other territories are not in the table.
  • quarters · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). flights: How many recent quarters to include in the trend (default 4, at most 20). The headline figure is always the latest quarter. AU: the range covers this many quarters of monthly fares (default 4 = 12 mon
  • age_group · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). childcare: Age of the child: infant (under 2), toddler (2), preschool (3 to 4 or until school), school-age. Each source says how it defines them. Leave out for the source's default (see the answer). GB: infant (
  • care_type · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). childcare: centre = nursery, daycare or group-based setting; home-based (also childminder) = a registered provider caring in their own home. Leave out for centres or for all providers, as the source says. GB: ce
  • community · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). tuition: BE only: the higher-education system, because Belgium has three with different fees: fr (French Community), nl (Flemish Community) or de (German-speaking Community).
  • component · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). construction: Which part of the cost: total (default), material (building materials) or labour (wages). BR: total (default) = average cost per m2; material = materials part; labour = labour part. All in BRL per m2,
  • flat_type · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). home-sales: SG only: HDB flat type. | rent: SG only: HDB flat type, one of 1-ROOM, 2-ROOM, 3-ROOM, 4-ROOM, 5-ROOM, EXECUTIVE ('4 ROOM' also works). Leave out for all types.
  • land_type · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). land-prices: Land type, e.g. 'arable', 'permanent grassland', 'arable or grassland' (rent only), 'irrigable arable' (price only). Leave out for the usual one. EU/NO, optional. For price: "arable" = Arable land; "p
  • buyer_area · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). contracts: Optional region or city to narrow to, see the country notes below. EU and EEA: the buyer's city, as written on the notice (e.g. 'Lyon', 'München'). GB: a region ('London', 'North West', 'Scotland', 'W
  • compare_to · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). price-levels: What the index is measured against, as a short name of a comparison area. Leave out for the default; the allowed values are listed in the notes for the country. OECD: 'OECD' (default, OECD average = 1
  • flat_class · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). rent: HK only: RVD flat class by saleable area, A (under 40 m²), B (40–69.9), C (70–99.9), D (100–159.9) or E (160 and over). Default B.
  • food_group · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). diet-costs: Which part of the healthy diet: leave out for the whole diet, or give 'fruit', 'vegetables', 'animal foods', 'legumes and nuts', 'oils and fats' or 'starchy staples'. The World Bank leaves some group
  • house_type · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). rent: Kind of house, for sources that publish houses by type (needed with property_type house there). CA: not used (houses are not published). GB: detached, semi-detached or terraced; required with property
  • study_mode · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). tuition: full-time (the default) or part-time. Canada: full-time only (the default). Europe, Eurydice: full-time (default) or part-time.
  • technology · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). home-upgrades: GB heat_pump: air_to_water (default), ground_source or biomass_boiler.
  • distributor · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). energy: BR only: the electricity distributor by ANEEL short name, for example 'CEMIG-D', 'ENEL SP', 'LIGHT', 'COPEL-DIS'. Leave out for the median of all distributors.
  • dwelling_type · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). home-upgrades: Type of dwelling or job, only where the publisher splits by it (the country notes say which values). Leave out for the publisher's main figure. GB solar_pv: leave out for all small installations (medi
  • lookback_days · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). wholesale-power: How many recent days of hourly prices to include. Default 7, at most 14. DE: 1 to 14 days of hourly prices (default 7); each hour counts as one record. AT/BE/DK/FR/IT/NL/NO/PL: 1 to 14 days of hourly
  • property_type · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). commercial-property: commercial = shops, offices, workshops and other commercial or industrial premises (default); land = building plots and other non-farm land sold without a building. FR: commercial (default) or land. A | home-sales: Kind of home. Default 'any'. AT: house or apartment (flats). The figure is the price per m² of living area. With no type given the headline is the flat figure and both medians are in extra.by_type. Th | rent: Kind of home: apartment (same as flat), house or room. Default 'any'. AU: apartment (flat or unit), house (includes terraces, townhouses and semi-detached) or any. Rooms are not published. CA: apartme
  • student_group · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). tuition: Who pays: home (nationals and EU students who pay home fees, the default), international (students from outside the EU/EEA), non-state-subsidised (self-financed places), specific-discipline (for examp
  • vehicle_class · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). cars: SG only: COE category. A = cars up to 1600cc (default), B = cars above 1600cc, C = goods vehicles/buses, D = motorcycles, E = open.
  • gasoline_grade · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). fuel: US only: the gasoline grade EIA publishes. Overrides the grade implied by fuel (petrol95 = regular, petrol98 = premium); use midgrade here with fuel=petrol95. Not for diesel.
  • consumption_band · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). energy: Standard household consumption band, by letter or by the publisher's code (the country notes list them). Leave out for the standard band. BR: not used (one residential tariff per distributor). EU/NO/I
  • postcode_district · string|number · optionnel
    Parameter of the category (same name and meaning as in its own tool). home-sales: GB only: postcode district such as 'BS8' to narrow the area.

  Exemple d'appel

  {"name": "pricepaid_check_price", "arguments": {"price": 1, "country": "texte", "category": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"input": {}, "answer": {}, "notice": "texte", "missing": [], "reasons": [], "summary": "texte", "verdict": "within_typical_range", "position": "texte"}}

• pricepaid_childcare_prices≈ 2958 tokens

  Use this when a user asks what childcare costs parents: the price of a nursery, daycare, childminder or after-school place for a baby, toddler, preschool or school-age child in a county, region, state or city, or how childcare prices compare, in England (country GB), Ireland (country IE), Norway (country NO) or the United States (country US). These are official surveys and statistics of the fees providers charge parents (or what households report paying), not adverts or listings, and they are before public subsidies or funded hours unless the answer says otherwise. Each answer is an official average or median (price_type official_statistic): the range fields are null, and there is a sample size only where the publisher gives one. Every answer states its unit (for example US dollars per week, or pounds per hour), the year it describes, a confidence label, and the official source and licence. How fresh: England: calendar year 2025 (survey fieldwork May to July 2025, published 11 December 2025; next release December 2026); Ireland: 2016 only (CSO has not repeated the table); regional, not county; ten years old; Norway: annual (January figures); the 2026 figures were published on 30 April 2026; the United States: county prices for 2022 (the latest year the Department of Labor has published; the database lags by several years). Some of this data is several years old: always read the period in the answer. Do not use for the cost of a specific nursery, advertised fees or waiting-list prices, the value of government subsidies, tuition for schools or universities, babysitting or nanny wages, or other countries.

  Paramètres, retour & exemple (5)

  Paramètres

  • area · string · optionnel
    Place: a county, a region, a local authority, or a state or city where the source says so (examples: 'Cook County, IL', 'London', 'Dublin'). Leave out for the whole country, where the source has a national figure. GB: England (leave out), a region (London, North West ...) or a local authority (Manchester, Leeds, Camden ...). Local authorities are published for 2 year olds and 3 and 4 year olds only. IE: a county, city or region such as Dublin, Cork, Galway or Mid-West; the answer is for the CSO region it belongs to. Leave out for the whole State. NO: a municipality such as Oslo, Bergen, Trondheim, Stavanger or Tromso (Norwegian spellings work). Leave out for the whole country. US: required. A county, for example 'Cook County, IL' or 'Harris County, Texas' (add the state when the name is not unique). Cities, ZIP codes and states are not published; use the county.
  • hours · string · optionnel · full-time | part-time
    Full-time or part-time care, where a source publishes both. Most sources publish one basis only and say which. GB: ignored; fees are per hour, with no full-time or part-time split. IE: ignored; the table averages part-time and full-time use. NO: ignored; the table gives one monthly average. US: full-time only (weekly prices); part-time is not published.
  • country · string · requis · GB | IE | NO | US
    GB = England only (DfE provider survey; Scotland, Wales and Northern Ireland are not covered); IE = Ireland (CSO survey of what households pay for childcare, 2016, by region); NO = Norway (Statistics Norway average kindergarten fees by municipality, January); US = United States (Department of Labor county childcare prices, 2022)
  • age_group · string · optionnel · infant | toddler | preschool | school-age
    Age of the child: infant (under 2), toddler (2), preschool (3 to 4 or until school), school-age. Each source says how it defines them. Leave out for the source's default (see the answer). GB: infant (under 2), toddler (2), preschool (3 and 4; default) or school-age (regions only). IE: only 'pre-school' (infant, toddler and preschool all give the pre-school children figure) or school-age (primary school children); leave out for all children aged 0 to 12. NO: ignored; the table averages all kindergarten children. US: infant (under 2), toddler (2), preschool (3 years old to school age) or school-age. Default infant.
  • care_type · string · optionnel · centre | home-based | childminder
    centre = nursery, daycare or group-based setting; home-based (also childminder) = a registered provider caring in their own home. Leave out for centres or for all providers, as the source says. GB: centre (shown as private group-based providers) or home-based (childminders); England as a whole only. Leave out for all providers. IE: ignored; the table averages all paid childcare. NO: ignored; the table averages all kindergartens. US: centre (child care centre; default) or home-based (family childcare in the provider's home; also written childminder).

  Exemple d'appel

  {"name": "pricepaid_childcare_prices", "arguments": {"country": "GB"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_commercial_property≈ 2144 tokens

  Use this when a user asks what shops, offices, workshops, warehouses or other commercial premises actually sold for, or what a plot of non-farm land (a building plot) sold for, per square metre, in a town or postcode, in France (country FR). Returns the median price per square metre, a typical range (10th–90th percentile), the number of sales, the period covered, a confidence label, and the official source and licence, from government sale records (prices paid, not asking prices). How fresh: twice a year, with a delay of several months. Do not use for homes, farmland, rents, asking prices or listings, the value of one particular building, or other countries.

  Paramètres, retour & exemple (5)

  Paramètres

  • town · string · optionnel
    Town or city. FR: town, e.g. 'Bordeaux', or use postcode.
  • months · integer · optionnel
    How many recent months to include. Default 24.
  • country · string · requis · FR
    FR = France (DVF)
  • postcode · string · optionnel
    Postcode, for a precise area. FR: 5-digit postcode, e.g. '33000'; use instead of town for a precise area.
  • property_type · string · optionnel · commercial | land
    commercial = shops, offices, workshops and other commercial or industrial premises (default); land = building plots and other non-farm land sold without a building. FR: commercial (default) or land. Alsace-Moselle and Mayotte are not covered.

  Exemple d'appel

  {"name": "pricepaid_commercial_property", "arguments": {"country": "FR"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_construction_costs≈ 2246 tokens

  Use this when a user asks what it costs to build a home or other building per square metre in Brazil (country BR), how much of that is materials and how much is labour, or how states or regions compare. Returns the official average cost per square metre for the latest month published, split into materials and labour, with the previous month, the official source and licence. This is a published survey average of unit costs (price_type official_statistic), not a range built from invoices or sales, so the range fields are null and there is no sample size. How fresh: monthly; the latest month on 16 Oct 2026 was September 2026. Do not use for the price of a finished home, for a builder's quote, for renovation work, or for countries that are not listed.

  Paramètres, retour & exemple (3)

  Paramètres

  • area · string · optionnel
    State or region, where the publisher splits by place (the country notes say how). Leave out for the national figure. BR: state name or two-letter code ('São Paulo', 'SP', 'Bahia', 'RJ'); leave out for the national figure (Brasil). States: RO = Rondônia, AC = Acre, AM = Amazonas, RR = Roraima, PA = Pará, AP = Amapá, TO = Tocantins, MA = Maranhão, PI = Piauí, CE = Ceará, RN = Rio Grande do Norte, PB = Paraíba, PE = Pernambuco, AL = Alagoas, SE = Sergipe, BA = Bahia, MG = Minas Gerais, ES = Espírito Santo, RJ = Rio de Janeiro, SP = São Paulo, PR = Paraná, SC = Santa Catarina, RS = Rio Grande do Sul, MS = Mato Grosso do Sul, MT = Mato Grosso, GO = Goiás, DF = Distrito Federal.
  • country · string · requis · BR
    BR = Brazil (all 27 states plus the national figure; IBGE SINAPI average cost per m2)
  • component · string · optionnel · total | material | labour
    Which part of the cost: total (default), material (building materials) or labour (wages). BR: total (default) = average cost per m2; material = materials part; labour = labour part. All in BRL per m2, monthly.

  Exemple d'appel

  {"name": "pricepaid_construction_costs", "arguments": {"country": "BR"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_contract_prices≈ 3012 tokens

  Use this when a user asks what governments, councils, hospitals or other public buyers actually paid for something (laptops, school meals, road resurfacing, office cleaning, electricity, ambulances, waste collection and similar purchases) in EU and EEA states (TED), the United Kingdom (Contracts Finder) or the United States (federal contracts). Returns, from official contract award notices, the median awarded value per contract, a typical range (10th–90th percentile), the number of awards, the period covered, a confidence label, and the official source and licence. Important: the figures are TOTAL values per contract (lot), not unit prices, unless the answer states a unit price (only when the notices give a quantity and unit). Nothing is returned for fewer than 5 awards, and individual suppliers are never named. How fresh: EU and EEA states (TED): daily on working days: notices appear on TED within days of the buyer sending them; the United Kingdom (Contracts Finder): continuous: buyers publish award notices after a contract is awarded; the United States (federal contracts): daily: agencies report contract actions within days and USAspending refreshes nightly. Do not use for what consumers or private companies pay, for tenders that are still open (those carry estimates, not prices paid), for the contracts of one named supplier, for asking prices, or for other countries.

  Paramètres, retour & exemple (5)

  Paramètres

  • cpv · string · optionnel
    Optional official product code, to be exact, where the source uses one (the country notes say which code system), e.g. the CPV code 30213100 for portable computers; a prefix such as 3021 covers the whole group. EU and EEA: an 8-digit CPV code (30213100) or a shorter prefix (3021) for a whole group; a lot counts when its own main product code is in that group. GB: a full 8-digit CPV code (45233142) instead of the keyword; only notices that list the code themselves are used. US: a product or service code (PSC, e.g. 7010 or psc:7010) or a NAICS code (e.g. 334111 or naics:334111) instead of the keyword; there are no CPV codes in the US.
  • what · string · requis
    What was bought, in plain words: 'laptops', 'school meals', 'road resurfacing', 'office cleaning', 'electricity', 'ambulances', 'waste collection'. Common purchases are matched to official product codes; anything else is searched as free text in the award notices. EU and EEA: common purchases are matched to CPV product codes (laptops, desktop computers, school meals, road resurfacing, office cleaning, electricity, natural gas, ambulances, waste collection and about 30 more, in English and the main EU languages); anything else is a free-text search of the award notices, best in the buyer country's language. GB: a keyword or phrase searched in the award notices (common purchases such as 'laptops' or 'road resurfacing' use a tuned keyword). Several words are searched as an exact phrase, so shorter is better. US: a phrase searched in the federal award descriptions (common purchases such as 'laptops' use a tuned keyword; 'road resurfacing' uses the road-repair product code Z2LB). Several words must appear together, so shorter is better.
  • months · integer · optionnel
    How many recent months of awards to include. Default 24. EU and EEA: up to 60; only the newest 1,000 matching notices are read, so a very common purchase covers a shorter period than asked (the answer says so). GB: 1 to 60 months, by award date. US: 1 to 60 months of new awards, read in up to 12 slices.
  • country · string · requis · AT | BE | BG | HR | CY | CZ | DK | EE
    EU and EEA states, by the country of the public buyer, as ISO codes: AT = Austria, BE = Belgium, BG = Bulgaria, HR = Croatia, CY = Cyprus, CZ = Czechia, DK = Denmark, EE = Estonia, FI = Finland, FR = France, DE = Germany, GR = Greece, HU = Hungary, IE = Ireland, IT = Italy, LV = Latvia, LT = Lithuania, LU = Luxembourg, MT = Malta, NL = the Netherlands, PL = Poland, PT = Portugal, RO = Romania, SK = Slovakia, SI = Slovenia, ES = Spain, SE = Sweden, IS = Iceland, LI = Liechtenstein, NO = Norway. Award notices above the EU procurement thresholds from TED.; GB = United Kingdom (Contracts Finder awarded contracts); US = United States, federal agencies' contracts only (not state or local governments)
  • buyer_area · string · optionnel
    Optional region or city to narrow to, see the country notes below. EU and EEA: the buyer's city, as written on the notice (e.g. 'Lyon', 'München'). GB: a region ('London', 'North West', 'Scotland', 'Wales', 'Yorkshire and The Humber' ...); nationwide contracts that list the region are included. US: a state name or code ('Virginia', 'VA'); filters by where the work is done.

  Exemple d'appel

  {"name": "pricepaid_contract_prices", "arguments": {"what": "texte", "country": "AT"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_coverage≈ 1024 tokens

  Use this to see which countries and kinds of price the tools cover. It returns a short overview: for each tool the countries it answers for, how many official sources stand behind it and how often they update. Give category and/or country to get the full detail of the matching sources instead (publisher, licence, attribution line, limits, example requests). Every source at once, as JSON: https://proofprice.com/api/v1/coverage

  Paramètres, retour & exemple (2)

  Paramètres

  • country · string · optionnel
    Optional. Return the full detail of the sources that cover this country: an ISO code such as IE, GB or FR. Can be combined with category.
  • category · string · optionnel
    Optional. Return the full detail of this category's sources: one of broadband, cars, childcare, commercial-property, construction, contracts, diet-costs, energy, farm-gate-prices, farm-prices, flights, fuel, groceries, home-sales, home-upgrades, hotels, insurance, land-prices, medical, medicines, price-levels, producer-prices, rent, tuition, wholesale-fresh-food, wholesale-markets, wholesale-power (the tool name also works).

  Exemple d'appel

  {"name": "pricepaid_coverage", "arguments": {"country": "texte", "category": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rules": [], "tools": [], "detail": "summary", "filter": {}, "purpose": "texte", "service": "texte", "sources": [], "summary": "texte", "examples": [], "coming_next": [], "source_count": 1, "full_coverage_url": "texte"}}

• pricepaid_diet_costs≈ 3779 tokens

  Use this when a user asks how much it costs to eat healthily in a country, for example the cost of the cheapest healthy diet per person per day, how that cost changed on a year earlier, or how much of it goes on fruit, vegetables, animal-source foods, legumes and nuts, oils and fats or starchy staples, in about 68 countries worldwide (World Bank estimates) (country IE), about 68 countries worldwide (World Bank estimates) (country GB), about 68 countries worldwide (World Bank estimates) (country FR), about 68 countries worldwide (World Bank estimates) (country ES), about 68 countries worldwide (World Bank estimates) (country PT), about 68 countries worldwide (World Bank estimates) (country IT), about 68 countries worldwide (World Bank estimates) (country DE), about 68 countries worldwide (World Bank estimates) (country NL), about 68 countries worldwide (World Bank estimates) (country BE), about 68 countries worldwide (World Bank estimates) (country AT), about 68 countries worldwide (World Bank estimates) (country PL), about 68 countries worldwide (World Bank estimates) (country DK), about 68 countries worldwide (World Bank estimates) (country SE), about 68 countries worldwide (World Bank estimates) (country NO), about 68 countries worldwide (World Bank estimates) (country FI), about 68 countries worldwide (World Bank estimates) (country GR), about 68 countries worldwide (World Bank estimates) (country LU), about 68 countries worldwide (World Bank estimates) (country CH), about 68 countries worldwide (World Bank estimates) (country IS), about 68 countries worldwide (World Bank estimates) (country CZ), about 68 countries worldwide (World Bank estimates) (country HU), about 68 countries worldwide (World Bank estimates) (country RO), about 68 countries worldwide (World Bank estimates) (country SK), about 68 countries worldwide (World Bank estimates) (country SI), about 68 countries worldwide (World Bank estimates) (country EE), about 68 countries worldwide (World Bank estimates) (country LV), about 68 countries worldwide (World Bank estimates) (country LT), about 68 countries worldwide (World Bank estimates) (country CY), about 68 countries worldwide (World Bank estimates) (country MT), about 68 countries worldwide (World Bank estimates) (country TR), about 68 countries worldwide (World Bank estimates) (country UA), about 68 countries worldwide (World Bank estimates) (country US), about 68 countries worldwide (World Bank estimates) (country CA), about 68 countries worldwide (World Bank estimates) (country MX), about 68 countries worldwide (World Bank estimates) (country BR), about 68 countries worldwide (World Bank estimates) (country AR), about 68 countries worldwide (World Bank estimates) (country CL), about 68 countries worldwide (World Bank estimates) (country CO), about 68 countries worldwide (World Bank estimates) (country PE), about 68 countries worldwide (World Bank estimates) (country AU), about 68 countries worldwide (World Bank estimates) (country NZ), about 68 countries worldwide (World Bank estimates) (country SG), about 68 countries worldwide (World Bank estimates) (country JP), about 68 countries worldwide (World Bank estimates) (country KR), about 68 countries worldwide (World Bank estimates) (country TW), about 68 countries worldwide (World Bank estimates) (country HK), about 68 countries worldwide (World Bank estimates) (country CN), about 68 countries worldwide (World Bank estimates) (country IN), about 68 countries worldwide (World Bank estimates) (country ID), about 68 countries worldwide (World Bank estimates) (country TH), about 68 countries worldwide (World Bank estimates) (country VN), about 68 countries worldwide (World Bank estimates) (country MY), about 68 countries worldwide (World Bank estimates) (country PH), about 68 countries worldwide (World Bank estimates) (country PK), about 68 countries worldwide (World Bank estimates) (country BD), about 68 countries worldwide (World Bank estimates) (country LK), about 68 countries worldwide (World Bank estimates) (country AE), about 68 countries worldwide (World Bank estimates) (country SA), about 68 countries worldwide (World Bank estimates) (country IL), about 68 countries worldwide (World Bank estimates) (country EG), about 68 countries worldwide (World Bank estimates) (country MA), about 68 countries worldwide (World Bank estimates) (country ZA), about 68 countries worldwide (World Bank estimates) (country NG), about 68 countries worldwide (World Bank estimates) (country KE), about 68 countries worldwide (World Bank estimates) (country GH), about 68 countries worldwide (World Bank estimates) (country TZ), about 68 countries worldwide (World Bank estimates) (country UG) or about 68 countries worldwide (World Bank estimates) (country ET). Returns the World Bank's modelled cost of a least-cost healthy diet, built from the food prices collected for the International Comparison Program: the figure in the country's own currency and in international (PPP) dollars, the year, the change on the previous year, the years since 2017, and the official source and licence. This is a modelled national estimate (price_type official_statistic), not a shop receipt, not what one household paid and not a range, so the range fields are null and there is no sample size. How fresh: roughly yearly: version 5.0 was last updated on 2026-07-21 and holds 2017 to 2025; every answer states its year. Do not use for the price of a particular food or shop, restaurant meals, a family's real food bill, or for countries that are not listed.

  Paramètres, retour & exemple (3)

  Paramètres

  • year · integer · optionnel
    Year of the estimate (2017 onwards). Leave out for the newest year the World Bank holds. World Bank: 2017 to the newest year held (2025 at the last check). Leave out for the newest year.
  • country · string · requis · IE | GB | FR | ES | PT | IT | DE | NL
    Countries as ISO codes: IE = Ireland, GB = United Kingdom, FR = France, ES = Spain, PT = Portugal, IT = Italy, DE = Germany, NL = Netherlands, BE = Belgium, AT = Austria, PL = Poland, DK = Denmark, SE = Sweden, NO = Norway, FI = Finland, GR = Greece, LU = Luxembourg, CH = Switzerland, IS = Iceland, CZ = Czechia, HU = Hungary, RO = Romania, SK = Slovakia, SI = Slovenia, EE = Estonia, LV = Latvia, LT = Lithuania, CY = Cyprus, MT = Malta, TR = Turkey, UA = Ukraine, US = United States, CA = Canada, MX = Mexico, BR = Brazil, AR = Argentina, CL = Chile, CO = Colombia, PE = Peru, AU = Australia, NZ = New Zealand, SG = Singapore, JP = Japan, KR = South Korea, TW = Taiwan, HK = Hong Kong, CN = China, IN = India, ID = Indonesia, TH = Thailand, VN = Vietnam, MY = Malaysia, PH = Philippines, PK = Pakistan, BD = Bangladesh, LK = Sri Lanka, AE = United Arab Emirates, SA = Saudi Arabia, IL = Israel, EG = Egypt, MA = Morocco, ZA = South Africa, NG = Nigeria, KE = Kenya, GH = Ghana, TZ = Tanzania, UG = Uganda, ET = Ethiopia. World Bank estimate for the whole country, one figure per year (2017 onwards).
  • food_group · string · optionnel
    Which part of the healthy diet: leave out for the whole diet, or give 'fruit', 'vegetables', 'animal foods', 'legumes and nuts', 'oils and fats' or 'starchy staples'. The World Bank leaves some group figures blank. World Bank: food_group is one of 'fruit', 'vegetables', 'animal foods' (meat, dairy, fish, eggs), 'legumes and nuts', 'oils and fats' or 'starchy staples' (grains, bread, rice, potatoes); leave out for the whole healthy diet. The figure is in the country's own currency per person per day, with international (PPP) dollars in the answer. Blank for some countries and years.

  Exemple d'appel

  {"name": "pricepaid_diet_costs", "arguments": {"country": "IE"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_energy_prices≈ 3157 tokens

  Use this when a user asks what households pay for electricity or natural gas per kWh in Brazil, the EU, Norway and Iceland, New Zealand or the United States, how that compares with another country, or how it changed since the previous period. Returns the official average price per kWh for a standard household consumption band, for the latest period published, with the same band excluding VAT and excluding all taxes, every band, the previous period and the change, and the official source and licence. This is a published average (price_type official_statistic), not a range built from sales, so the range fields are null and there is no sample size. How fresh: Brazil: updated whenever ANEEL homologates a tariff adjustment (each distributor adjusts once a year); each answer states the validity period of the tariff; the EU, Norway and Iceland: updated twice a year (half-yearly figures); each answer states its reference period, and the newest half-year Eurostat holds for the country is returned; New Zealand: monthly file; the newest month is about four to five months behind today. Each answer states its month.; the United States: monthly: EIA adds a month to each table about two months after it ends (electricity in the last week of the month, natural gas at the month's end); our copy is refreshed daily and each answer states its month. Do not use for business or industrial tariffs, for a specific supplier's offer or a quote for a particular home, for petrol and diesel, or for other countries.

  Paramètres, retour & exemple (7)

  Paramètres

  • state · string · optionnel
    US only: the state, by name or postal code ('Texas', 'TX', 'DC'). Leave out for the U.S. average. Gas: EIA publishes no figure for a few states in recent months, then the newest published month is returned and the answer says so.
  • taxes · string · optionnel · all | excl_vat | none
    Tax level of the price. 'all' = all taxes and levies included (what a household pays, default); 'excl_vat' = excluding VAT and other recoverable taxes; 'none' = excluding all taxes and levies. BR: not used. ANEEL tariffs are always before taxes (ICMS, PIS/COFINS) and flag surcharges. NZ: prices always include GST (15%); only 'all' (or leaving it out) works. US: not used (EIA publishes one average per state).
  • energy · string · requis · electricity | gas
    electricity or gas (natural gas). BR: electricity only (no gas). The figure is the regulated residential tariff (TE energy + TUSD network) before taxes and flag surcharges, as a posted price. EU/NO/IS: Eurostat currently has no recent household gas price for CY, FI, IS, MT or NO (status no_matches). NZ: electricity only (no gas). A modelled average from retail tariffs, shown as an official statistic. US: electricity = average residential price in US cents per kWh (Electric Power Monthly); gas = average residential natural gas price in US dollars per thousand cubic feet (Natural Gas Monthly). EIA gives gas per Mcf, not per kWh, so the two cannot be compared directly.
  • region · string · optionnel
    NZ only: electricity network region, for example 'Auckland', 'Wellington', 'Christchurch', 'Dunedin'. Leave out for the unweighted median across all regions.
  • country · string · requis · BR | AT | BE | BG | HR | CY | CZ | DK
    BR = Brazil (ANEEL: regulated residential electricity tariff per distributor, R$ per kWh before taxes); EU member states plus NO and IS, as ISO codes (GR for Greece): AT = Austria, BE = Belgium, BG = Bulgaria, HR = Croatia, CY = Cyprus, CZ = Czechia, DK = Denmark, EE = Estonia, FI = Finland, FR = France, DE = Germany, GR = Greece, HU = Hungary, IE = Ireland, IT = Italy, LV = Latvia, LT = Lithuania, LU = Luxembourg, MT = Malta, NL = Netherlands, PL = Poland, PT = Portugal, RO = Romania, SK = Slovakia, SI = Slovenia, ES = Spain, SE = Sweden, NO = Norway, IS = Iceland; NZ = New Zealand (Electricity Authority: modelled average household electricity price per kWh incl. GST, by network region, NZD); US = United States (U.S. Energy Information Administration: average residential electricity price in cents per kWh and residential natural gas price in US$ per thousand cubic feet, by state, monthly)
  • distributor · string · optionnel
    BR only: the electricity distributor by ANEEL short name, for example 'CEMIG-D', 'ENEL SP', 'LIGHT', 'COPEL-DIS'. Leave out for the median of all distributors.
  • consumption_band · string · optionnel
    Standard household consumption band, by letter or by the publisher's code (the country notes list them). Leave out for the standard band. BR: not used (one residential tariff per distributor). EU/NO/IS, annual consumption. Electricity: ALL = all consumption bands together; DA = under 1,000 kWh a year; DB = 1,000 to 2,499 kWh a year; DC = 2,500 to 4,999 kWh a year; DD = 5,000 to 14,999 kWh a year; DE = 15,000 kWh a year or more; default DC. Gas: ALL = all consumption bands together; D1 = under 20 GJ a year (under about 5,600 kWh); D2 = 20 to 199 GJ a year (about 5,600 to 55,000 kWh); D3 = 200 GJ a year or more (about 55,600 kWh and over); default D2. ALL = all bands together. Eurostat codes such as KWH2500-4999 or GJ20-199 also work. NZ: 'standard' (default, standard household user) or 'low' (low user). US: not used (EIA publishes one average for all residential customers in a state).

  Exemple d'appel

  {"name": "pricepaid_energy_prices", "arguments": {"energy": "electricity", "country": "BR"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_farm_gate_prices≈ 2496 tokens

  Use this when a user asks what farmers received, per month, for a crop or animal product (wheat, barley, oats, canola, soybeans, corn, potatoes, cattle, hogs, lambs, chickens, turkeys, milk, eggs) in a region of Canada, or how that price compares with the month before or a year earlier. Returns the newest monthly price the statistics office publishes for the product and region, in the unit the office uses (per tonne, per hundredweight, per dozen, per kilolitre), the month it applies to, the change on the previous month and a year earlier, the last 12 months, the same product in other regions, and the official source and licence. This is a published monthly average price received by farmers (price_type official_statistic), not a range built from sales, so the range fields are null and there is no sample size. How fresh: monthly, not live: Statistics Canada publishes each month's averages about six weeks after the month ends (August 2026 was released on 9 October 2026), and every answer states its reference month. Always read the month in the answer. Do not use for supermarket or shop prices, for wholesale market quotes, for the price of a particular farm, field or animal, for farmland, for fuel or energy, for futures prices, or for EU member states.

  Paramètres, retour & exemple (3)

  Paramètres

  • region · string · optionnel
    Region inside the country, as the statistics office publishes it (for example a province or state). Some countries publish no national figure, so the answer then asks for a region. Canada: a province is required (Ontario, Quebec, Saskatchewan, Alberta, Manitoba, British Columbia, Nova Scotia, New Brunswick, Prince Edward Island, Newfoundland and Labrador). Statistics Canada publishes no Canada total in this table. A city such as Saskatoon is answered with its province. Not every product is published for every province.
  • country · string · requis · CA
    CA = Canada (Statistics Canada: monthly average prices received by farmers, by province, official statistic, not a live price)
  • product · string · requis
    The crop or animal product, e.g. 'wheat', 'barley', 'oats', 'canola', 'soybeans', 'corn', 'potatoes', 'cattle', 'hogs', 'lambs', 'chickens', 'milk', 'eggs'. The full list is in the tool notes. Canada: a crop or animal product in everyday words, e.g. wheat, milling wheat, feed wheat, durum, oats, barley, feed barley, malt barley, soybeans, corn, flaxseed, canola, rye, lentils, dry peas, canary seed, potatoes, seed potatoes, table potatoes, processing potatoes, cattle, cows, steers, heifers, calves, lambs, feeder cattle, feeder steers, feeder heifers, feeder calves. Prices are in Canadian dollars in Statistics Canada's own unit for each series (per metric tonne for grains and oilseeds, per hundredweight for cattle, hogs and potatoes, per kilolitre for milk, per dozen for eggs); the answer names the unit.

  Exemple d'appel

  {"name": "pricepaid_farm_gate_prices", "arguments": {"country": "CA", "product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_farm_prices≈ 2777 tokens

  Use this when a user asks what farmers or wholesalers get for a food commodity (wheat, barley, maize, beef, pigs, lamb, chicken, eggs, milk, butter and other dairy products, olive oil, fruit and vegetables) in EU member states, how that price compares with last week, last month or a year ago, or how high it is against the last 12 months. Returns the latest official price for the country and product, per tonne or per 100 kg and per kg, for the week (milk: month) it applies to, the stage of the supply chain it is quoted at (farm gate, ex-silo, carcass, ex-packaging station), the change from the previous period and from a year earlier, the last 12 months, the other series the portal holds, and the official source and licence. This is a published price (price_type official_statistic), not a range built from trades, so the range fields are null and there is no sample size. How fresh: weekly for most products (raw milk monthly), updated as Member States report, usually within days (raw milk about two weeks after the month ends). Each answer states its week or month and flags quotes that are older than usual (fruit and vegetables are only quoted in season). Always read the period in the answer: an old quote is flagged and given lower confidence. Do not use for supermarket or shop prices, for the price of a particular farm, field, animal or meal, for farmland, for fuel or energy, for futures or stock-market prices, or for other countries.

  Paramètres, retour & exemple (2)

  Paramètres

  • country · string · requis · AT | BE | BG | HR | CY | CZ | DK | EE
    EU member states, as ISO codes (GR for Greece): AT = Austria, BE = Belgium, BG = Bulgaria, HR = Croatia, CY = Cyprus, CZ = Czechia, DK = Denmark, EE = Estonia, FI = Finland, FR = France, DE = Germany, GR = Greece, HU = Hungary, IE = Ireland, IT = Italy, LV = Latvia, LT = Lithuania, MT = Malta, NL = Netherlands, PL = Poland, PT = Portugal, RO = Romania, SK = Slovakia, SI = Slovenia, ES = Spain, SE = Sweden. Not covered: LU (the portal holds no Luxembourg prices) and countries outside the EU such as GB and NO. Not every country reports every product (olive oil: ES, IT, PT, GR and HR only; dairy products about 16 countries); the answer says when a product is missing.
  • product · string · requis
    The product, e.g. 'wheat', 'barley', 'beef', 'pig', 'lamb', 'chicken', 'eggs', 'milk', 'butter', 'olive oil', 'tomatoes', 'apples'. The full list is in the tool notes. EU: required. The product, by name; aliases such as 'pork', 'corn', 'tomato' are understood. Prices are weekly (raw milk monthly), per tonne for cereals and per 100 kg otherwise (piglets per head), each answer also gives the price per kg. Cereals (per tonne): wheat, milling wheat, feed wheat, durum wheat, barley, malting barley, maize, rye, oats, triticale. Beef (per 100 kg of carcass): beef, young bull, steer, heifer, cow, calf. Pigs, lamb and poultry meat (per 100 kg; piglets per head): pig, piglet, lamb, heavy lamb, light lamb, chicken, chicken breast, chicken legs. Eggs (per 100 kg): eggs, barn eggs, cage eggs, free range eggs, organic eggs. Milk and dairy (per 100 kg): milk, organic milk, butter, skimmed milk powder, whole milk powder, cheddar, gouda, edam, emmental, whey powder, cream, drinking milk. Olive oil (per 100 kg): olive oil, extra virgin olive oil, virgin olive oil, lampante olive oil. Fruit and vegetables (per 100 kg): apples, pears, peaches, nectarines, apricots, cherries, plums, strawberries, oranges, lemons, mandarins, clementines, bananas, table grapes, kiwis, melons, water melons, tomatoes, cucumbers, courgettes, peppers, egg plants, lettuces, cauliflowers, carrots, onions, cabbage, leeks, garlic, mushrooms, beans, asparagus, avocados. Products with several series (wheat: milling then feed; pig: class E; beef: adult male cattle indicative price) show the usual one and list the others in extra.other_series. Fruit and vegetables are only quoted in season.

  Exemple d'appel

  {"name": "pricepaid_farm_prices", "arguments": {"country": "AT", "product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_fuel_price_history≈ 2750 tokens

  Use this when a user asks how pump prices have changed over recent days or weeks in a place, or whether fuel is getting cheaper. Returns the daily median and typical range of pump prices in the area, with the change over the period, from our daily snapshots of official data. Do not use for today's cheapest stations. After 10 free calls a day per caller this tool costs USD 0.02 per answered call, paid with x402 (USDC); a 402 reply lists how. Nothing is charged for "not enough records" or errors.

  Paramètres, retour & exemple (9)

  Paramètres

  • area · string · optionnel
    Wider area when no postcode. BR: state as a two-letter code or name ('SP', 'Minas Gerais'); leave empty for all Brazil. Canada: same as town (a city, or 'Canada'). Provinces are not published. ES: province code ('28' = Madrid). EU Weekly Oil Bulletin countries: not used (national average only). FR: department ('69', '2A'). GB: not used (national average only). IT: province ('MI', 'RM'). MX: state name or code ('Ciudad de México', 'CDMX', 'Jalisco', 'NLE'); leave empty for all Mexico. Only states are available. MY: not used (national price only). NZ: not used (national price only). TW: not used (island-wide price only). US: a state ('TX', 'California') or PADD region ('Gulf Coast', 'PADD 1B', 'West Coast'); leave empty for the national average. EIA publishes gasoline for CA, CO, FL, MA, MN, NY, OH, TX and WA, diesel only for California plus the nation and PADD regions. Any other place gets the national average, and the answer says so (with its region as context).
  • days · integer · optionnel
    How many recent days to include. Default 30.
  • fuel · string · requis · diesel | petrol95 | petrol98 | e10 | e85 | lpg | methane
    petrol95 = unleaded 95; methane = CNG (priced per kg). Brazil: petrol95 = regular petrol (gasolina comum, not RON 95) or diesel (= diesel S10). Other fuels are not covered. Canada: petrol95 = regular unleaded gasoline (87 AKI, about 91 RON), petrol98 = premium unleaded, diesel; self-service stations. E10, E85, LPG and CNG are not published. EU Weekly Oil Bulletin countries: petrol95 (Euro-super 95), diesel (automotive gas oil) or lpg, as a national average per litre in euro with all taxes; heating gas oil is in the extra fields. Other fuels are not published. GB: petrol95 (unleaded petrol, ULSP) or diesel (ULSD) only, as a national average in pounds per litre; other fuels are not published. Italy: diesel, petrol95, lpg, methane only. Mexico: petrol95 = regular petrol (gasolina regular, Magna), petrol98 = premium petrol, or diesel. Mexican grades are not 95 or 98 RON. MY: diesel, petrol95 (RON95, unsubsidised rate) or petrol98 (answered with RON97). Subsidised BUDI95/SKPS/SKDS prices are in extra.subsidised_myr_per_litre. NZ: diesel, or petrol95 (MBIE's Premium Petrol 95R; petrol98 gets the same series). Regular petrol 91 is returned in extra.other_fuels. TW: diesel (premium diesel), petrol95 (95 unleaded) or petrol98 (98 unleaded), in NT$ per litre with VAT and excise. 92 unleaded and 95E3 gasohol are in the extra fields. US: petrol95 = regular gasoline, petrol98 = premium gasoline, diesel = on-highway diesel (all types). For midgrade gasoline use petrol95 with gasoline_grade=midgrade. Prices are weekly averages in US dollars per gallon, taxes included (US$ per litre is in extra). EIA publishes no E10, E85, LPG or CNG prices.
  • town · string · optionnel
    Town name. BR: municipality, e.g. 'São Paulo' or 'Curitiba'; add area when the name exists in several states. Canada: one of the 18 cities Statistics Canada tracks (St. John's, Charlottetown and Summerside, Halifax, Saint John, Québec, Montréal, Ottawa-Gatineau, Toronto, Thunder Bay, Winnipeg, Regina, Saskatoon, Edmonton, Calgary, Vancouver, Victoria, Whitehorse, Yellowknife), or 'Canada' for the national average (regular unleaded only). Leave town and area out for the national average. ES: town name, e.g. 'Valencia'. EU Weekly Oil Bulletin countries: not used (national average only). GB: not used (national average only). IT: comune name, e.g. 'Bologna'. MX: not used for cities; a state name given here works like area. MY: not used. One national price per week; any place is answered with the Malaysia price and the answer says so. NZ: not used. MBIE publishes one national price per week; any place is answered with the New Zealand average and the answer says so. TW: not used. CPC posts one island-wide price; any place is answered with the Taiwan price and the answer says so. US: one of the ten cities EIA publishes (Boston, Chicago, Cleveland, Denver, Houston, Los Angeles, Miami, New York City, San Francisco, Seattle), gasoline only; otherwise the national average is returned and the answer says so.
  • months · integer · optionnel
    Instead of days: how many whole months of monthly history to return, where a source has loaded long history.
  • country · string · requis · BR | CA | ES | IE | DE | NL | BE | PT
    BR = Brazil (ANP weekly survey: regular petrol and diesel S10); CA = Canada (Statistics Canada: monthly average retail price by city, official statistic, not a live pump price); ES = Spain; EU Weekly Oil Bulletin, national average pump prices: IE = Ireland, DE = Germany, NL = the Netherlands, BE = Belgium, PT = Portugal, PL = Poland, DK = Denmark, SE = Sweden, FI = Finland, LU = Luxembourg, GR = Greece, CZ = Czechia, SK = Slovakia, SI = Slovenia, HR = Croatia, HU = Hungary, RO = Romania, BG = Bulgaria, EE = Estonia, LV = Latvia, LT = Lithuania, CY = Cyprus, MT = Malta; FR = France; GB = United Kingdom (DESNZ weekly national average pump prices of unleaded petrol and diesel); IT = Italy; MX = Mexico (by state); MY = Malaysia (weekly government-set national price; an official published price, not a station price); NZ = New Zealand (MBIE weekly national average retail price; an official statistic, not a station price); TW = Taiwan (posted island-wide list price of CPC Corporation; a posted price, not a station price); US = United States (U.S. Energy Information Administration: weekly average retail gasoline and diesel prices in US$ per gallon for the nation, PADD regions, 9 states and 10 cities)
  • service · string · optionnel · self | served
    Self-service or attended service, where a country prices them differently. Canada: self only. Full-service prices stopped in 2013. EU Weekly Oil Bulletin countries: not used. GB: not used. IT: self-service (default) or attended service, which costs more. MY: not used. NZ: not used. TW: not used. US: not used.
  • postcode · string · optionnel
    Postcode of the place. BR: not used (the survey is published by state and municipality). Canada: not used. ES: 5-digit postcode, e.g. '28001'. EU Weekly Oil Bulletin countries: not used; the bulletin publishes one national average per country, so the national figure is returned and says so. FR: 5-digit postcode, e.g. '75015'. GB: not used; DESNZ publishes one UK average, so the national figure is returned and says so. MX: not used. MY: not used (national price only). NZ: not used (national price only). TW: not used (island-wide price only). US: not used (EIA publishes no ZIP-code prices).
  • gasoline_grade · string · optionnel · regular | midgrade | premium
    US only: the gasoline grade EIA publishes. Overrides the grade implied by fuel (petrol95 = regular, petrol98 = premium); use midgrade here with fuel=petrol95. Not for diesel.

  Exemple d'appel

  {"name": "pricepaid_fuel_price_history", "arguments": {"fuel": "diesel", "country": "BR"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"unit": "texte", "query": {}, "change": "texte", "method": "texte", "notice": "texte", "period": {}, "series": [], "source": {}, "status": "ok", "library": {}, "summary": "texte", "currency": "texte"}}

• pricepaid_fuel_prices_now≈ 3964 tokens

  Use this when a user asks the current price of petrol, diesel, E10, E85, LPG or CNG near a place in Brazil, Canada, Spain, the EU (national averages), France, the United Kingdom (national averages), Italy, Mexico, Malaysia, New Zealand, Taiwan or the United States, or where fuel is cheapest there. Returns the median and typical range of pump prices across stations in the area, the three cheapest stations, and the official source and licence. How fresh: Brazil: ANP publishes the survey as one file per month, so the newest survey week is usually one to four weeks old. Our copy is refreshed daily, and every answer states the survey week it describes; Canada: monthly, not live: Statistics Canada publishes each month's averages about two weeks after the month ends (August 2026 was released on 14 September 2026), and every answer states its reference month; Spain: several times a day; the EU (national averages): weekly: Monday prices, published that week; France: about every 10 minutes; the United Kingdom (national averages): weekly: one national figure each week, usually available the same week; Italy: daily (prices at 08:00 of the extraction day); Mexico: the feeds are current prices reported by the stations and carry no timestamps; our copy is taken once a day and every answer shows the day of that copy; Malaysia: weekly, on Thursdays; New Zealand: weekly (Fridays), using the previous week's data; the newest weeks are marked Provisional by MBIE and revised; Taiwan: changes usually on Mondays; the next week's list price is published the day before; the United States: weekly: EIA dates each figure to the Monday it describes and publishes it a day or two later (a day later after a federal holiday); our copy of EIA's history files is refreshed daily and every answer states its week. Do not use for other countries or for historical prices.

  Paramètres, retour & exemple (7)

  Paramètres

  • area · string · optionnel
    Wider area when no postcode. BR: state as a two-letter code or name ('SP', 'Minas Gerais'); leave empty for all Brazil. Canada: same as town (a city, or 'Canada'). Provinces are not published. ES: province code ('28' = Madrid). EU Weekly Oil Bulletin countries: not used (national average only). FR: department ('69', '2A'). GB: not used (national average only). IT: province ('MI', 'RM'). MX: state name or code ('Ciudad de México', 'CDMX', 'Jalisco', 'NLE'); leave empty for all Mexico. Only states are available. MY: not used (national price only). NZ: not used (national price only). TW: not used (island-wide price only). US: a state ('TX', 'California') or PADD region ('Gulf Coast', 'PADD 1B', 'West Coast'); leave empty for the national average. EIA publishes gasoline for CA, CO, FL, MA, MN, NY, OH, TX and WA, diesel only for California plus the nation and PADD regions. Any other place gets the national average, and the answer says so (with its region as context).
  • fuel · string · requis · diesel | petrol95 | petrol98 | e10 | e85 | lpg | methane
    petrol95 = unleaded 95; methane = CNG (priced per kg). Brazil: petrol95 = regular petrol (gasolina comum, not RON 95) or diesel (= diesel S10). Other fuels are not covered. Canada: petrol95 = regular unleaded gasoline (87 AKI, about 91 RON), petrol98 = premium unleaded, diesel; self-service stations. E10, E85, LPG and CNG are not published. EU Weekly Oil Bulletin countries: petrol95 (Euro-super 95), diesel (automotive gas oil) or lpg, as a national average per litre in euro with all taxes; heating gas oil is in the extra fields. Other fuels are not published. GB: petrol95 (unleaded petrol, ULSP) or diesel (ULSD) only, as a national average in pounds per litre; other fuels are not published. Italy: diesel, petrol95, lpg, methane only. Mexico: petrol95 = regular petrol (gasolina regular, Magna), petrol98 = premium petrol, or diesel. Mexican grades are not 95 or 98 RON. MY: diesel, petrol95 (RON95, unsubsidised rate) or petrol98 (answered with RON97). Subsidised BUDI95/SKPS/SKDS prices are in extra.subsidised_myr_per_litre. NZ: diesel, or petrol95 (MBIE's Premium Petrol 95R; petrol98 gets the same series). Regular petrol 91 is returned in extra.other_fuels. TW: diesel (premium diesel), petrol95 (95 unleaded) or petrol98 (98 unleaded), in NT$ per litre with VAT and excise. 92 unleaded and 95E3 gasohol are in the extra fields. US: petrol95 = regular gasoline, petrol98 = premium gasoline, diesel = on-highway diesel (all types). For midgrade gasoline use petrol95 with gasoline_grade=midgrade. Prices are weekly averages in US dollars per gallon, taxes included (US$ per litre is in extra). EIA publishes no E10, E85, LPG or CNG prices.
  • town · string · optionnel
    Town name. BR: municipality, e.g. 'São Paulo' or 'Curitiba'; add area when the name exists in several states. Canada: one of the 18 cities Statistics Canada tracks (St. John's, Charlottetown and Summerside, Halifax, Saint John, Québec, Montréal, Ottawa-Gatineau, Toronto, Thunder Bay, Winnipeg, Regina, Saskatoon, Edmonton, Calgary, Vancouver, Victoria, Whitehorse, Yellowknife), or 'Canada' for the national average (regular unleaded only). Leave town and area out for the national average. ES: town name, e.g. 'Valencia'. EU Weekly Oil Bulletin countries: not used (national average only). GB: not used (national average only). IT: comune name, e.g. 'Bologna'. MX: not used for cities; a state name given here works like area. MY: not used. One national price per week; any place is answered with the Malaysia price and the answer says so. NZ: not used. MBIE publishes one national price per week; any place is answered with the New Zealand average and the answer says so. TW: not used. CPC posts one island-wide price; any place is answered with the Taiwan price and the answer says so. US: one of the ten cities EIA publishes (Boston, Chicago, Cleveland, Denver, Houston, Los Angeles, Miami, New York City, San Francisco, Seattle), gasoline only; otherwise the national average is returned and the answer says so.
  • country · string · requis · BR | CA | ES | IE | DE | NL | BE | PT
    BR = Brazil (ANP weekly survey: regular petrol and diesel S10); CA = Canada (Statistics Canada: monthly average retail price by city, official statistic, not a live pump price); ES = Spain; EU Weekly Oil Bulletin, national average pump prices: IE = Ireland, DE = Germany, NL = the Netherlands, BE = Belgium, PT = Portugal, PL = Poland, DK = Denmark, SE = Sweden, FI = Finland, LU = Luxembourg, GR = Greece, CZ = Czechia, SK = Slovakia, SI = Slovenia, HR = Croatia, HU = Hungary, RO = Romania, BG = Bulgaria, EE = Estonia, LV = Latvia, LT = Lithuania, CY = Cyprus, MT = Malta; FR = France; GB = United Kingdom (DESNZ weekly national average pump prices of unleaded petrol and diesel); IT = Italy; MX = Mexico (by state); MY = Malaysia (weekly government-set national price; an official published price, not a station price); NZ = New Zealand (MBIE weekly national average retail price; an official statistic, not a station price); TW = Taiwan (posted island-wide list price of CPC Corporation; a posted price, not a station price); US = United States (U.S. Energy Information Administration: weekly average retail gasoline and diesel prices in US$ per gallon for the nation, PADD regions, 9 states and 10 cities)
  • service · string · optionnel · self | served
    Self-service or attended service, where a country prices them differently. Canada: self only. Full-service prices stopped in 2013. EU Weekly Oil Bulletin countries: not used. GB: not used. IT: self-service (default) or attended service, which costs more. MY: not used. NZ: not used. TW: not used. US: not used.
  • postcode · string · optionnel
    Postcode of the place. BR: not used (the survey is published by state and municipality). Canada: not used. ES: 5-digit postcode, e.g. '28001'. EU Weekly Oil Bulletin countries: not used; the bulletin publishes one national average per country, so the national figure is returned and says so. FR: 5-digit postcode, e.g. '75015'. GB: not used; DESNZ publishes one UK average, so the national figure is returned and says so. MX: not used. MY: not used (national price only). NZ: not used (national price only). TW: not used (island-wide price only). US: not used (EIA publishes no ZIP-code prices).
  • gasoline_grade · string · optionnel · regular | midgrade | premium
    US only: the gasoline grade EIA publishes. Overrides the grade implied by fuel (petrol95 = regular, petrol98 = premium); use midgrade here with fuel=petrol95. Not for diesel.

  Exemple d'appel

  {"name": "pricepaid_fuel_prices_now", "arguments": {"fuel": "diesel", "country": "BR"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_grocery_prices≈ 4586 tokens

  Use this when a user asks what an everyday grocery item (milk, bread, eggs, butter, cheese, chicken, bananas, potatoes, sugar, tea, coffee, beer, wine...) costs in the shops in Canada (country CA), the United Kingdom (country GB), Ireland (country IE), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country AF), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country AM), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country BD), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country BF), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country BI), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country BJ), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country BO), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country CD), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country CF), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country CI), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country CM), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country DJ), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country ET), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country GM), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country GN), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country GW), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country HT), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country ID), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country IN), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country IQ), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country JO), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country KG), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country LA), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country LB), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country LR), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country LS), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country ML), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country MM), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country MR), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country MW), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country MZ), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country NE), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country NG), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country NP), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country PH), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country PK), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country RW), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country SD), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country SL), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country SN), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country SO), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country SS), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country TD), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country TG), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country TL), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country TZ), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country UA), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country UG), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country YE), countries WFP surveys (Africa, Asia, Middle East, Latin America) (country ZW) or the United States (country US), or how that price has changed over the last year. Returns the official average or median shop price that the national statistics office publishes for a standard item, built from the shelf prices its price collectors record in shops for the consumer price index (shelf prices observed by price collectors, not receipts and not what one shopper paid; some offices also use retailers' scanner data), with the exact item definition (for example 'Full-fat milk, per 2 litres'), the unit, the reference month, the change on a year earlier where the office publishes comparable figures (an answer carries none where the office advises against comparing months), the official source and licence. Each country defines its own standard items, so the item definition in the answer matters and related definitions are listed. How fresh: Canada: monthly, not live: Statistics Canada publishes each month's averages about five weeks after the month ends (August 2026 was released on 7 October 2026), and every answer states its reference month; the United Kingdom: monthly: ONS publishes each month's file about three to four weeks after the month ends (August 2026 appeared in late September); our copy is refreshed daily and each answer states its reference month; Ireland: monthly, published with the Consumer Price Index (usually the second week of the following month); each answer states its reference month; countries WFP surveys (Africa, Asia, Middle East, Latin America): WFP files are updated about monthly (HDX file last modified 2026-10-12); the newest observation in a country is often 1 to 5 months old; our copy is refreshed daily; the United States: monthly: BLS releases the new month about the 10th to 14th of the following month; our copy is refreshed daily and each answer states its reference month. This is a published national (or regional) average, not a range of individual transactions, so the range fields can be null. Do not use for the price at a particular supermarket or online shop, loyalty-card or special-offer prices, restaurant meals, petrol or diesel, or for other countries.

  Paramètres, retour & exemple (3)

  Paramètres

  • item · string · requis
    Everyday item in plain words, e.g. 'milk', 'white bread', 'eggs', 'butter', 'coffee', 'bananas', 'beer'. Each country measures its own standard pack or cut; the answer names it and lists other definitions. Canada: Statistics Canada's 110 standard products, each in one standard size, e.g. milk, 1 litre milk, 4 litre milk, soy milk, nut milk, cream, butter, margarine, cheese, yogurt, eggs, ground beef, steak, sirloin. Milk is published per 1, 2 and 4 litres (2 litres by default); the answer names the exact product and lists the other sizes. GB: ONS's product types, each in one pack size, e.g. eggs (free-range, pack of 12), milk (whole, 4 pints), semi-skimmed milk (2 pints), bread (sliced white, 800 g), butter (250 g), cheese (cheddar, per kg), chicken (whole, per kg), beef mince (per kg), bananas, apples, potatoes (per kg), rice, pasta, instant coffee, tea bags, sugar, lager, wine. IE: the CSO's standard items, e.g. milk (full-fat, 2 litres), white bread (800 g sliced pan), eggs (large, half dozen), butter (per lb), cheese (Irish cheddar), chicken (whole bird), bananas, potatoes, sugar, tea bags, beer (can of lager), wine (75 cl), whiskey, pint of stout or lager (bar). The CSO has no coffee, mince or cereal. WFP countries: a staple food in plain words ('rice', 'wheat flour', 'maize', 'beans', 'sugar', 'cooking oil', 'milk', 'onions', 'tomatoes', 'chicken'). WFP names foods its own way, e.g. 'Rice (high quality)'; the answer names the food and lists other definitions. Add 'wholesale' for wholesale prices, otherwise retail. US: the BLS's standard items, e.g. eggs (grade A large, per dozen), milk (whole, per gallon), bread (white pan bread, per lb), butter, cheddar cheese, chicken, ground beef, steak, bacon, bananas, oranges, potatoes, tomatoes, rice, pasta, flour, sugar, coffee (ground, per lb), soft drinks, beer, wine, ice cream. BLS has no tea or apples (dropped) and publishes most items per pound.
  • region · string · optionnel
    Region inside the country, only where the statistics office publishes regional averages. Leave out for the national average. Canada: leave out for the Canada average, or give a province (Ontario, BC, Quebec ...), Whitehorse (or Yukon) or Yellowknife (or Northwest Territories). A city such as Toronto is answered with its province's average. The two territories start in September 2025 and lack some products. GB: leave out for the whole UK, or give an English region (North East, North West, Yorkshire and the Humber, East Midlands, West Midlands, East of England, London, South East, South West), Scotland, Wales or Northern Ireland (a big city maps to its region). ONS withholds a regional figure when fewer than ten observations stand behind it. IE: national averages only; a region is ignored and the answer says so. WFP countries: leave out. Figures are a spread across the country's surveyed markets. US: leave out for the U.S. city average, or give northeast, midwest, south or west (a US state maps to its region). BLS publishes no state or city averages for food.
  • country · string · requis · CA | GB | IE | AF | AM | BD | BF | BI
    CA = Canada (Statistics Canada: monthly average retail prices of 110 selected products, national and provincial, official statistic, not a live price); GB = United Kingdom (Office for National Statistics: median shop prices of about 200 grocery and drink product types, monthly, UK and 12 regions and nations); IE = Ireland (Central Statistics Office: national average shop prices of about 76 standard items, monthly); Countries as ISO codes: AF = Afghanistan, AM = Armenia, BD = Bangladesh, BF = Burkina Faso, BI = Burundi, BJ = Benin, BO = Bolivia, CD = Democratic Republic of the Congo, CF = Central African Republic, CI = Cote d'Ivoire, CM = Cameroon, DJ = Djibouti, ET = Ethiopia, GM = Gambia, GN = Guinea, GW = Guinea-Bissau, HT = Haiti, ID = Indonesia, IN = India, IQ = Iraq, JO = Jordan, KG = Kyrgyzstan, LA = Laos, LB = Lebanon, LR = Liberia, LS = Lesotho, ML = Mali, MM = Myanmar, MR = Mauritania, MW = Malawi, MZ = Mozambique, NE = Niger, NG = Nigeria, NP = Nepal, PH = Philippines, PK = Pakistan, RW = Rwanda, SD = Sudan, SL = Sierra Leone, SN = Senegal, SO = Somalia, SS = South Sudan, TD = Chad, TG = Togo, TL = Timor-Leste, TZ = Tanzania, UA = Ukraine, UG = Uganda, YE = Yemen, ZW = Zimbabwe. World Food Programme market surveys of staple foods; a country with no recent survey of 5 or more markets answers 'no matches'.; US = United States (Bureau of Labor Statistics: average retail prices of about 45 standard food and drink items, monthly, national and four regions)

  Exemple d'appel

  {"name": "pricepaid_grocery_prices", "arguments": {"item": "texte", "country": "CA"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_home_sales≈ 4828 tokens

  Use this when a user asks what homes actually sold for in a town or area, what a fair price for a home is, or how much property costs there, in Austria (country AT), Australia (country AU), Belgium (country BE), Denmark (country DK), Finland (country FI), France (country FR), England & Wales (country GB), Ireland (country IE), the Netherlands (country NL), Norway (country NO), Portugal (country PT), Sweden (country SE), Singapore public housing (country SG), Taiwan (country TW) or the United States (Connecticut, New York City and Cook County IL only) (country US). Returns the median sale price, a typical range (10th–90th percentile), the number of sales, the period covered, a confidence label, and the official source and licence, from government sale records. Do not use for rents, asking prices, commercial property, or other countries.

  Paramètres, retour & exemple (9)

  Paramètres

  • town · string · optionnel
    Town or city. AT: a municipality among the 100 largest ('Wien' / 'Vienna', 'Graz', 'Linz', 'Salzburg', 'Innsbruck'), a district ('Wien 2' for Leopoldstadt, 'Bezirk Baden', 'Kitzbühel'), or a Bundesland ('Tirol', 'Niederösterreich' / 'Lower Austria'). Omit for Austria. Official annual medians per m², not a list of sales. AU: a state or territory ('Victoria', 'NSW', 'Queensland', 'Tasmania', 'ACT'), or a city or town that lies in one ('Melbourne', 'Parramatta', 'Perth'). The ABS publishes by state and territory only, so a city is answered with its state (and the answer says so). Omit for Australia as a whole. BE: a municipality in Dutch, French or English ('Antwerpen' / 'Antwerp' / 'Anvers', 'Gent' / 'Ghent', 'Brussel' / 'Bruxelles' / 'Brussels', 'Liège'), or a province ('province of Namur') or region ('Flanders', 'Wallonia', 'Brussels Capital Region'). Omit for Belgium. Official Statbel medians, not a list of sales. DK: a municipality or town ('København' or 'Copenhagen', 'Aarhus' or 'Århus', 'Odense', 'Aalborg'), a province ('Fyn', 'Østjylland', 'Nordsjælland') or a region ('Hovedstaden', 'Syddanmark'), with or without æ ø å. Statistics Denmark publishes by province, so a municipality is answered with the province it lies in (and the answer says which). Omit for Denmark as a whole. FI: a municipality ('Helsinki' or 'Helsingfors', 'Espoo', 'Tampere', 'Oulu', 'Hämeenlinna'), a region ('Uusimaa', 'Pirkanmaa'), 'Greater Helsinki', with or without ä ö å. Omit for Finland as a whole. Larger cities, regions and the country have quarterly figures (with the official price-index changes); other municipalities have the latest yearly figure. FR: town, e.g. 'Bordeaux', or use postcode. GB: required, e.g. 'Bristol'. IE: a county ('Cork') or Dublin postal district ('Dublin 6'). Omit for all of Ireland. NL: a municipality ('Amsterdam', 'Den Haag' / 'The Hague' / 's-Gravenhage, 'Utrecht') or a province ('Noord-Holland'). Omit for the national average. Official CBS annual average, not a list of sales. NO: a municipality ('Oslo', 'Bergen', 'Tromsø' or 'Tromso', 'Stavanger') or a county ('Rogaland', 'Vestland'), Norwegian or Sami spelling, with or without æ ø å. Omit for the whole country. Answers are Statistics Norway's published average price per m² (NOK) with the number of sales, not a list of sales. PT: a municipality INE publishes ('Lisboa' / 'Lisbon', 'Porto' / 'Oporto', 'Cascais', 'Faro', 'Funchal' ... 58 in all) or a region ('Algarve', 'Grande Lisboa', 'Madeira', 'Açores'). Omit for Portugal as a whole. Official INE median per m² of the last 12 months of sales, not a list of sales. SE: a municipality ('Stockholm', 'Göteborg' or 'Gothenburg', 'Malmö' or 'Malmo', 'Uppsala'), a county ('Skåne', 'Stockholms län') or a metropolitan area ('Greater Gothenburg'), with or without å ä ö. Omit for Sweden as a whole. Answers are Statistics Sweden's published average purchase price (SEK per home) with the number of sales, not a list of sales. SG: required, one of the 26 HDB towns, e.g. 'Tampines', 'Ang Mo Kio', 'Bukit Merah', 'Kallang/Whampoa', 'Central Area' (case, hyphens and ', Singapore' are forgiven; 'Kallang' and 'CBD' are understood). TW: a city or county in English or Chinese ('Taipei' / '台北市' / '臺北市', 'New Taipei', 'Taichung', 'Kaohsiung', 'Tainan', 'Taoyuan', 'Hsinchu City', 'Hsinchu County'), or a district with its city ("Da'an, Taipei", '臺北市大安區', 'Banqiao, New Taipei'). Omit for all of Taiwan. A district name used in several cities ('Zhongzheng', 'Dongqu') needs the city too. US: a Connecticut town ('Hartford'), a New York City borough or neighborhood ('Brooklyn', 'Williamsburg'), 'Chicago', 'Cook County' or a Cook County assessment township ('Evanston', 'Oak Park'). Add the state if a name exists in two places ('Hartford, CT'). Required unless postcode is a New York City ZIP.
  • state · string · optionnel
    US only: 'CT' (Connecticut), 'NY' (New York City) or 'IL' (Cook County). Usually inferred from the place; set it when a name exists in two of them.
  • county · string · optionnel
    IE only: same as town; a county such as 'Dublin' or 'Cork'.
  • months · integer · optionnel
    How many recent months to include. Default 12. AT: ignored; STATISTIK AUSTRIA publishes one figure per calendar year (the latest is returned). AU: not used; the ABS publishes one mean price per quarter. BE: ignored; Statbel publishes quarters, half-years and years, and the latest period with a figure for the place is returned. DK: not used; Statistics Denmark publishes one average per quarter. FI: not used; Statistics Finland publishes one average per quarter (postcodes, cities) or year (municipalities). IE: rounded to the nearest of 3, 6, 12, 24 or 36. NL: ignored; CBS publishes one average per calendar year (the latest is returned). NO: not used; Statistics Norway publishes one figure per quarter and the answer gives the latest quarter plus the previous one and a year earlier. PT: ignored; INE publishes one median per quarter, covering the 12 months to the quarter's end (the latest is returned). SE: not used; Statistics Sweden publishes one figure per year (municipalities, flats) or quarter (counties). TW: 12 or 24 whole calendar months; up to 18 gives 12 (24 if a place has too few sales in 12), more gives 24. The window ends at the last month that is at least 30 days old. US: 1 to 36 months back from the latest sale in the file (New York City: up to 12).
  • country · string · requis · AT | AU | BE | DK | FI | FR | GB | IE
    AT = Austria (official STATISTIK AUSTRIA median price per m² of houses and flats, annual); AU = Australia (the Australian Bureau of Statistics' official mean price of residential dwellings, by state and territory; an official statistic of the whole dwelling stock, not individual sales and not a suburb price); BE = Belgium (official Statbel median sale prices by property type, quarterly); DK = Denmark (official average price per property from Statistics Denmark, by province and region; an official statistic, not individual sales); FI = Finland (official average price per m² of old dwellings in housing companies from Statistics Finland, by municipality, region or postcode; an official statistic, not individual sales); FR = France (DVF); GB = England & Wales (HM Land Registry); IE = Ireland (Property Price Register); NL = Netherlands (official CBS average sale price per municipality, annual); NO = Norway (official average price per m² from Statistics Norway, by municipality or county; an official statistic, not individual sales); PT = Portugal (official INE median sale price per m², quarterly, by region and municipality); SE = Sweden (official average purchase price from Statistics Sweden, by municipality or county; an official statistic, not individual sales); SG = Singapore HDB resale flats; TW = Taiwan (Ministry of the Interior actual price registration: every registered sale, summarised by city or county and district); US = United States, partial: Connecticut, New York City and Cook County IL (Chicago area) only; not nationwide
  • postcode · string · optionnel
    Postcode, for a precise area. AT: only Vienna postcodes (1010 to 1230) are matched, to the Vienna district; elsewhere give the town or district as town. AU: a 4-digit postcode ('2150'), answered with the state or territory it lies in (the ABS has no postcode figures). BE: not supported (Statbel publishes by municipality); give the municipality as town. DK: not supported (Statistics Denmark publishes by province and region); give town instead. FI: a five-digit postcode (for example 00100): the latest quarterly figure for that postal code area. Flats are published by number of rooms, so the answer is the room size with most transactions and the others are listed. FR: 5-digit postcode, e.g. '69003'; use instead of town for a precise area. NL: not supported (CBS publishes by municipality); give the municipality as town. NO: not supported (Statistics Norway publishes by municipality); give town instead. PT: not supported (INE publishes by region and municipality); give the municipality as town. SE: not supported (Statistics Sweden publishes by municipality); give town instead. TW: not supported (the register has no postcodes); give the city, county or district as town. US: 5-digit ZIP code, New York City only (Connecticut and Cook County have no ZIP in the public file).
  • flat_type · string · optionnel · 1 ROOM | 2 ROOM | 3 ROOM | 4 ROOM | 5 ROOM | EXECUTIVE | MULTI-GENERATION
    SG only: HDB flat type.
  • property_type · string · optionnel · house | apartment | villa | detached | semi-detached | terraced | flat | flat-maisonette
    Kind of home. Default 'any'. AT: house or apartment (flats). The figure is the price per m² of living area. With no type given the headline is the flat figure and both medians are in extra.by_type. There is no figure for both together or for villas, detached, semi-detached or terraced homes. AU: not split by the ABS; the figure covers all residential dwellings (houses and attached dwellings together). Any value is accepted and noted. BE: house (all houses, not apartments), apartment, or detached / villa (houses with 4 or more facades), semi-detached or terraced (houses with 2 or 3 facades). Statbel has no figure for houses and apartments together, so without a type you get both medians in the summary and no single price. DK: house (one-family houses), flat (owner-occupied flats). Without a type, the group with more sales in that place is answered and the other is in extra. Detached and terraced are not published separately. FI: flat (flats in blocks of flats), terraced (terraced houses, which also include detached houses with shares in a housing company). Without a type, all building types. House and detached are not covered. FR: house or apartment. GB: detached, semi-detached, terraced or flat-maisonette. IE: any, new or second-hand (new homes are usually recorded without VAT). NL: CBS does not split this figure by home type; only 'any' (all existing owner-occupied homes) has an answer. NO: any (all dwellings, default), house or detached (detached houses), terraced (row houses), flat (multi-dwelling buildings). Official price per m² of existing dwellings. PT: INE splits by number of bedrooms, not by house or apartment; only 'any' has an answer (the answer includes the split by bedrooms). SE: house (one- and two-dwelling buildings; the default for any), flat (tenant-owned flats, median price, county or metropolitan area only). Villas, terraced and semi-detached houses are not split, so detached and terraced return no figure. TW: apartment (high-rise, mid-rise and walk-up flats together), house (透天厝), high-rise (住宅大樓, 11+ floors with a lift), mid-rise (華廈, up to 10 floors with a lift) or walk-up (公寓, up to 5 floors, no lift). Default any = all homes. US: any (default), house (one- to three-family houses and townhomes), condo, or coop (New York City only).
  • postcode_district · string · optionnel
    GB only: postcode district such as 'BS8' to narrow the area.

  Exemple d'appel

  {"name": "pricepaid_home_sales", "arguments": {"country": "AT"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_home_upgrade_prices≈ 2730 tokens

  Use this when a user asks what a home upgrade costs in England and Wales (heat pumps) (country GB), Great Britain (country GB) or Ireland (country IE): a heat pump, solar panels (solar PV), loft/attic or wall insulation, or new windows. Returns an official statistic: the cost that installers or owners declared when a grant or tax claim was made (a median or average the publisher states for a period), with the period, the publisher's own wording of what the figure includes, the official source and licence. These are declared installed costs at grant or claim, not receipts, not quotes and not what one home paid; price_type is official_statistic, so the range fields can be null and the sample size is given only where the publisher states it. Each source covers only some measures: where a measure is not published the answer says so (status no_matches) instead of guessing. How fresh: England and Wales (heat pumps): monthly (the cost tables are updated each quarter, in January, April, July and October; the latest quarter ends about three months earlier); Great Britain: yearly (published each May for the financial year just ended; April to March); Ireland: irregular; the local-authority table currently ends with 2018/19. Some countries publish only a general renovation figure that is not split by type of work (the country notes say so). Do not use for a quote on a particular home, for installer prices or offers, for running costs or savings, or for other countries.

  Paramètres, retour & exemple (6)

  Paramètres

  • area · string · optionnel
    Place, only where the publisher splits by place (the country notes say how). Leave out for the national figure. GB: national figures only; an area is ignored and the answer says so. IE: a county (Kerry, Cork, Dublin, Galway...) or a local authority (Fingal, DLR, Cork City...); leave out for all of Ireland.
  • country · string · requis · GB | IE
    GB = England and Wales for heat pumps (Boiler Upgrade Scheme statistics) and Great Britain for solar panels; GB = Great Britain (solar PV: DESNZ declared installed cost per kW from MCS certificates; heat pumps: Boiler Upgrade Scheme statistics; England and Wales for heat pumps, Great Britain for solar); IE = Ireland (Revenue Home Renovation Incentive: declared value of renovation works by county; not split by type of work; SEAI figures are not included yet)
  • measure · string · requis · heat_pump | solar_pv | attic_insulation | wall_insulation | windows | renovation
    The upgrade: heat_pump, solar_pv, attic_insulation, wall_insulation, windows, or renovation (any home renovation works, where the publisher does not split by type). Plain words such as 'heat pump' or 'loft insulation' are accepted. GB: solar_pv (DESNZ, per kW installed) and heat_pump (Boiler Upgrade Scheme, per installation). Insulation and windows have no open GB cost statistic yet and return no_matches. IE: only renovation (any qualifying work). The Home Renovation Incentive is not split by heat pump, solar, insulation or windows, so those measures return no_matches.
  • size_kw · number · optionnel
    GB solar_pv: system size in kW; picks the DESNZ size band (0-4, 4-10 or 10-50 kW). Default: the 0-4 kW band.
  • technology · string · optionnel
    GB heat_pump: air_to_water (default), ground_source or biomass_boiler.
  • dwelling_type · string · optionnel
    Type of dwelling or job, only where the publisher splits by it (the country notes say which values). Leave out for the publisher's main figure. GB solar_pv: leave out for all small installations (median); or domestic, non-domestic, retrofit (domestic, existing home) or new build (domestic): these are means. GB heat_pump: not published, ignored. IE: not published, ignored.

  Exemple d'appel

  {"name": "pricepaid_home_upgrade_prices", "arguments": {"country": "GB", "measure": "heat_pump"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_hotel_prices≈ 2360 tokens

  Use this when a user asks what a hotel room costs per night, on average, in a country, region, province or city in Spain (country ES) or Norway (country NO), or how hotel prices changed on a year earlier. Returns the official average daily rate: the average price actually charged per occupied hotel room per night, published monthly by the national statistics office from its hotel survey, with the month, the change on the same month a year earlier where published, the official source and licence. This is a published average over all hotels in the area, not a range of individual bookings and not a quote for a date, so the range fields are null and there is no sample size. How fresh: Spain: monthly, published about six weeks after the month ends; every answer states its month. Monthly history back to 2008; Norway: monthly, published about five weeks after the month ends; every answer states its month. Do not use for the price of one named hotel, a booking for particular dates, holiday rentals or hostels, or for countries that are not listed.

  Paramètres, retour & exemple (3)

  Paramètres

  • area · string · optionnel
    Region, province or city inside the country, in plain words (for example 'Madrid', 'Andalucia', 'Benidorm'). Leave out for the national average. ES: optional. A region ('Andalucia', 'Cataluña', 'Madrid'), a province ('Málaga', 'Cádiz', 'Illes Balears') or a tourist city or resort ('Benidorm', 'Barcelona', 'Alicante') as INE names them; accents are optional. Leave out for the Spain-wide average. A name that is both a province and a city gives the province and lists the other. NO: optional. A county ('Oslo', 'Vestland', 'Rogaland', 'Troms', 'Svalbard') or a main city ('Bergen', 'Stavanger', 'Trondheim', 'Tromso') as SSB counts them; Norwegian spellings work. Leave out for the whole country.
  • stars · integer · optionnel
    Hotel star category (1 to 5), for sources that publish it. Only national figures are split by stars; do not combine with area. ES: optional, 1 to 5 hotel stars. INE publishes star categories for Spain as a whole only, so do not combine with area. NO: not used (SSB publishes no star split).
  • country · string · requis · ES | NO
    ES = Spain (INE hotel survey, average price charged per occupied room per night, in euro); NO = Norway (Statistics Norway hotel statistics, average price per occupied room per night, in NOK)

  Exemple d'appel

  {"name": "pricepaid_hotel_prices", "arguments": {"country": "ES"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_insurance_prices≈ 2117 tokens

  Use this when a user asks what insurance actually costs the people who hold it, for example what homeowners pay per year for flood insurance in a ZIP code or state, in the United States (federal flood insurance) (country US). Returns the median yearly charge with the typical range (10th to 90th percentile) across real policies, the number of policies behind it, the period, a confidence label, and the official source and licence. Only aggregates are returned, never one policy, and never fewer than 5 policies. Read the method in the answer: some premiums are set partly by public rules, so they are real charges but not a free-market quote. How fresh: updated about monthly (data as of 2026-09-08 when checked); every answer states the period it covers. Do not use for a personal quote, for insurance that is not covered by a source here, for the value or replacement cost of a home, or for other countries.

  Paramètres, retour & exemple (2)

  Paramètres

  • area · string · optionnel
    Place: a 5-digit ZIP code or a state code, depending on the country notes (examples: '32935', 'TX'). Required. US: required. A 5-digit ZIP code ('32935') or a 2-letter state or territory code ('TX', 'FL'). Flood insurance from the National Flood Insurance Program only; fewer than 5 policies in the last 12 months gives no figure.
  • country · string · requis · US
    US = United States (federal flood insurance, NFIP, from FEMA OpenFEMA)

  Exemple d'appel

  {"name": "pricepaid_insurance_prices", "arguments": {"country": "US"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_land_prices≈ 2710 tokens

  Use this when a user asks what agricultural land (farmland, arable land or grassland) sells for, or what it costs to rent, per hectare in EU member states and Norway, in a particular region of such a country, or how it changed since the year before. Returns the official average price per hectare (or the average rent per hectare for one year) for the latest year published, in the currency the answer states (euro and national currency where the source gives both), for the chosen land type (arable, permanent grassland and others), the previous year and change, the history, the other land types, the regions that exist, and the official source and licence. This is a published average (price_type official_statistic), not a range built from sales, so the range fields are null and there is no sample size. How fresh: annual. Eurostat publishes land data with a lag of about two years (on 2026-10-14 the newest year is 2024) and some countries are further behind; each answer states its reference year and flags old figures. Always read the reference year in the answer: the data are about two years behind and some countries are much older. Do not use for the value of a particular field or farm, for house or building land or commercial property, for listings or asking prices, or for other countries.

  Paramètres, retour & exemple (4)

  Paramètres

  • region · string · optionnel
    Optional region code for a regional figure, where the source publishes one (the country notes say which codes). Leave out for the whole country. EU/NO, optional. A NUTS region code (Eurostat's regional land data), e.g. ES51 = Cataluña, ES61 = Andalucía, FRJ2 = Midi-Pyrénées, IE05 = Southern, NL32 = Noord-Holland, PT11 = Norte, PL91 = Warszawski stołeczny, SE11 = Stockholm. Leave out for the whole country. Every national answer lists its regions in extra.regions_available. Regions exist only for some countries and years: a code Eurostat does not hold gets a clear no_matches.
  • country · string · requis · AT | BE | BG | HR | CZ | DK | EE | FI
    EU member states and Norway, as ISO codes (GR for Greece): AT = Austria, BE = Belgium, BG = Bulgaria, HR = Croatia, CZ = Czechia, DK = Denmark, EE = Estonia, FI = Finland, FR = France, GR = Greece, HU = Hungary, IE = Ireland, IT = Italy, LV = Latvia, LT = Lithuania, LU = Luxembourg, MT = Malta, NL = Netherlands, NO = Norway, PL = Poland, PT = Portugal, RO = Romania, SK = Slovakia, SI = Slovenia, ES = Spain, SE = Sweden. Not covered: DE, CY (Eurostat holds no farmland data) and GB. Belgium's sale prices end in 2014 and Italy's in 2020; Norway has rents only.
  • measure · string · requis · price | rent
    price = what agricultural land sells for per hectare; rent = what it costs to rent per hectare for one year. EU/NO: price = average sale price of agricultural land per hectare (Eurostat apri_lprc); rent = average rent for one year per hectare (apri_lrnt). Rents exist for most countries, prices for most but not NO.
  • land_type · string · optionnel
    Land type, e.g. 'arable', 'permanent grassland', 'arable or grassland' (rent only), 'irrigable arable' (price only). Leave out for the usual one. EU/NO, optional. For price: "arable" = Arable land; "permanent grassland" = Permanent grassland; "irrigable arable" = Irrigable arable land; "non-irrigable arable" = Non-irrigable arable land. For rent: "arable" = Arable land; "permanent grassland" = Permanent grassland; "arable or grassland" = Arable land and/or permanent grassland. Leave out for the usual one (price: arable; rent: arable and/or grassland). Not every country reports every land type; the answer lists what exists.

  Exemple d'appel

  {"name": "pricepaid_land_prices", "arguments": {"country": "AT", "measure": "price"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_medical_prices≈ 2676 tokens

  Use this when a user asks what a medical service or hospital stay costs, or what was actually paid for it, for example an office visit, an MRI, a colonoscopy, physical therapy, a knee replacement or a pneumonia stay, in Singapore (hospital bills for medical conditions) (country SG) or the United States (what Medicare paid doctors and hospitals) (country US). Returns the official average amount the public health insurer allowed per service (doctors' services, in an office or a facility) or paid per hospital stay (by hospital-stay group), nationally or for one state where the source publishes it, with the number of services or discharges behind it, the share the insurer itself paid, the national average for comparison and the data year, plus the official source and licence. These are public-insurance rates (price_type official_statistic): what the insurer allowed or paid, NOT private-insurance negotiated prices or cash prices, which are usually higher, and not a quote. A published average, so the range fields are null. Facility figures are the doctor's fee only; the hospital's or surgery centre's fee is separate. How fresh: Singapore (hospital bills for medical conditions): annual benchmark file (data year 2023, file last updated 15 May 2026); every answer states its data year; the United States (what Medicare paid doctors and hospitals): annual: one calendar year at a time (the 2024 data year was released in 2026); every answer states its data year. Do not use for a quote or what a specific hospital or doctor charges, private-insurance or out-of-pocket costs, drug or prescription prices, dental or vision plans, or other countries.

  Paramètres, retour & exemple (4)

  Paramètres

  • state · string · optionnel
    A state or territory, where the source publishes one (the country notes say how to write it). Leave out for the national average. Singapore: the ward class, because Singapore has no states: c = public subsidised Ward C (default), b2 = public subsidised Ward B2, b1 = public unsubsidised Ward B1, a = public unsubsidised Ward A, private = private hospital. US: a state or territory as a two-letter code or name (TX, Texas). Leave out for the national average.
  • country · string · requis · SG | US
    SG = Singapore (Ministry of Health: median and middle-half hospital bills for medical conditions, Singapore Citizens, 2023); US = United States (what Medicare paid, nationally or by state)
  • service · string · requis
    The medical service: plain words ('office visit', 'MRI lower back', 'knee replacement'), a billing code or a hospital-stay group code, as the country notes list them. Required. Singapore: a medical condition in plain words ('stroke', 'dementia', 'delirium', 'spinal cord conditions') or an MOH DRG code ('B70A'). Surgery and doctor visits are not covered. US: plain words ('office visit', 'MRI lower back', 'colonoscopy', 'physical therapy', 'knee replacement', 'pneumonia'), a billing code (HCPCS/CPT such as 99213 or G0121) or an MS-DRG hospital-stay code ('DRG 470').
  • setting · string · optionnel · office | facility | inpatient
    office = a doctor's office (whole service); facility = hospital outpatient or surgery centre (doctor's fee only); inpatient = a hospital stay. Leave out to use the usual setting for the service. Singapore: only inpatient (a hospital stay); leave out. US: office (a doctor's office; the whole service), facility (a hospital outpatient department or surgery centre; the doctor's fee only) or inpatient (a hospital stay, by MS-DRG). Leave out to use the usual setting for the service.

  Exemple d'appel

  {"name": "pricepaid_medical_prices", "arguments": {"country": "SG", "service": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_medicine_prices≈ 2511 tokens

  Use this when a user asks what a medicine costs in a pharmacy, or how much of the price the health insurance reimburses, in Spain (country ES), France (country FR), England (NHS) (country GB), Italy (country IT), New Zealand (country NZ) or the United States (country US). Returns the median and typical range (10th–90th percentile) of the legally fixed price per box across all pack sizes and strengths sold under that medicine name, the number of packs, the period, a confidence label, and the official source and licence. These are regulated (posted) prices, not market transactions, and only for reimbursable medicines. Do not use for over-the-counter products with free prices or for other countries.

  Paramètres, retour & exemple (2)

  Paramètres

  • country · string · requis · ES | FR | GB | IT | NZ | US
    ES = Spain (Ministerio de Sanidad Nomenclator: legally fixed public prices of medicines billed to the national health service); FR = France (public medicines database: legally fixed prices of reimbursable medicines); GB = England (NHS Prescription Cost Analysis: the basic price the NHS reimburses for the drug, per tablet/capsule/ml, not a patient price; England only); IT = Italy (AIFA transparency list: public prices of reimbursable off-patent class A medicines); NZ = New Zealand (PHARMAC Pharmaceutical Schedule: list prices of subsidised community medicines, NZD); US = United States (NADAC: the average price retail pharmacies pay to acquire a drug, weekly, per tablet/capsule/mL/gram; not the patient's counter price)
  • medicine · string · requis
    Medicine brand or active-substance name, e.g. 'doliprane' or 'paracetamol'. Only the first word is used. ES: Spanish active-ingredient or brand name, first word used ('paracetamol', 'ibuprofeno', 'omeprazol', 'dolocatil'). Needs 5+ packs on sale under that name. FR: brand or active substance, first word used ('doliprane', 'paracetamol', 'amoxicilline'). Needs 5+ priced packs under that name. GB: generic or brand name, optionally with strength and form ('omeprazole', 'atorvastatin 20mg', 'Lipitor', 'paracetamol tablets'). NHS names follow the British National Formulary (the common American names are mapped). Returns the NHS net ingredient cost per unit and per 28-unit supply. IT: Italian active-substance or brand name, first word used ('paracetamolo', 'amoxicillina', 'glucobay'). Needs 5+ packs under that name. Off-patent reimbursable (class A) medicines only. NZ: English chemical or brand name, first word used ('paracetamol', 'amoxicillin', 'panadol'). Needs 5+ subsidised packs under that name. Subsidised community medicines only; list prices, not what patients paid. US: generic or brand name, optionally with strength and form ('atorvastatin', 'atorvastatin 20mg', 'metformin 500 mg tablet', 'Lipitor'). NADAC uses American generic names ('acetaminophen' for paracetamol, 'albuterol' for salbutamol; the common British names are mapped). Returns the per-unit cost to the pharmacy.

  Exemple d'appel

  {"name": "pricepaid_medicine_prices", "arguments": {"country": "ES", "medicine": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_price_levels≈ 3912 tokens

  Use this when a user asks how expensive a country is compared with an international average, for everyday spending such as food, housing, transport, health, clothing or restaurants, for example 'is food dearer here than in a neighbouring country', 'how much more expensive is a country than the average' or what a dollar buys in local currency (purchasing power parity), in 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country AU), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country AT), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country BE), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country CA), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country CL), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country CO), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country CR), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country CZ), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country DK), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country EE), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country FI), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country FR), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country DE), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country GR), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country HU), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country IS), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country IE), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country IL), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country IT), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country JP), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country KR), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country LV), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country LT), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country LU), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country MX), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country NL), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country NZ), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country NO), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country PL), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country PT), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country SK), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country SI), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country ES), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country SE), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country CH), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country TR), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country GB), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country US), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country BG), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country CY), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country MT), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country RO), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country AL), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country BA), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country MK), 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country ME) or 47 countries (the 38 OECD members plus Bulgaria, Cyprus, Malta, Romania and some Balkan states) (country RS). Returns the price level index (100 = the comparison average, 120 = prices 20% above it), the PPP rate in national currency, the year, the last years, the rank among the countries surveyed, and the official source and licence. This is a price level index from the international PPP survey (price_type official_statistic), not a shop price, not a receipt and not a range, so the range fields are null and there is no sample size. How fresh: yearly: the newest published year was 2024 at the last check (2022 onwards); every answer states its year. Do not use for the price of a particular product, a town or city, exchange rates on the money market, or for countries that are not listed.

  Paramètres, retour & exemple (3)

  Paramètres

  • spend · string · optionnel
    What kind of spending: leave out for all household consumption, or give 'food', 'meat', 'dairy', 'bread and cereals', 'fruit', 'vegetables', 'alcohol', 'tobacco', 'clothing', 'housing' (rent, water, energy), 'furnishings', 'health', 'transport', 'cars', 'communication', 'recreation', 'education', 'restaurants and hotels', 'goods' or 'services'. OECD: spend is one of 'food', 'meat', 'fish', 'dairy', 'bread and cereals', 'oils and fats', 'fruit', 'vegetables', 'sugar', 'soft drinks', 'alcohol', 'tobacco', 'clothing', 'housing' (rent, water, energy), 'furnishings', 'health', 'transport', 'cars', 'communication', 'recreation', 'education', 'restaurants and hotels', 'goods' or 'services'; leave out for all household consumption. The index is for the whole country, not a city.
  • country · string · requis · AU | AT | BE | CA | CL | CO | CR | CZ
    Countries as ISO codes: AU = Australia, AT = Austria, BE = Belgium, CA = Canada, CL = Chile, CO = Colombia, CR = Costa Rica, CZ = Czechia, DK = Denmark, EE = Estonia, FI = Finland, FR = France, DE = Germany, GR = Greece, HU = Hungary, IS = Iceland, IE = Ireland, IL = Israel, IT = Italy, JP = Japan, KR = South Korea, LV = Latvia, LT = Lithuania, LU = Luxembourg, MX = Mexico, NL = Netherlands, NZ = New Zealand, NO = Norway, PL = Poland, PT = Portugal, SK = Slovakia, SI = Slovenia, ES = Spain, SE = Sweden, CH = Switzerland, TR = Turkey, GB = United Kingdom, US = United States, BG = Bulgaria, CY = Cyprus, MT = Malta, RO = Romania, AL = Albania, BA = Bosnia and Herzegovina, MK = North Macedonia, ME = Montenegro, RS = Serbia. OECD/Eurostat PPP survey: one price level index per country, year and spending group, whole country.
  • compare_to · string · optionnel
    What the index is measured against, as a short name of a comparison area. Leave out for the default; the allowed values are listed in the notes for the country. OECD: 'OECD' (default, OECD average = 100), 'USA' (United States = 100) or 'EU' (EU-27 average = 100).

  Exemple d'appel

  {"name": "pricepaid_price_levels", "arguments": {"country": "AU"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_producer_prices≈ 2374 tokens

  Use this when a user asks what farmers received at the farm gate, per year, for a crop or animal product (wheat, maize, rice, soybeans, potatoes, tomatoes, apples, bananas, beef, pork, chicken, eggs, milk, coffee, cotton and many more) in 9 countries from FAOSTAT (US, CA, BR, MX, AU, NZ, SG, JP, KR), or how that annual price changed from the year before. Returns the newest annual producer price for the country and product, per tonne in the country's own currency (and in US dollars where available) and per kg, the year it applies to, the change on the previous year, whether the source marks the figure as estimated, related products, and the official source and licence. This is a published official statistic (price_type official_statistic), not a range built from sales, so the range fields are null and there is no sample size. How fresh: annual. FAO refreshes the file a few times a year and the newest year is usually one to two years behind today; our copy is refreshed daily and each answer states its reference year and whether FAO marks it as estimated. Always read the year in the answer: the newest annual figure is often one to two years old. Do not use for weekly or daily market quotes, for supermarket or shop prices, for the price of a particular farm, field or animal, for farmland, for fuel or energy, or for futures prices.

  Paramètres, retour & exemple (2)

  Paramètres

  • country · string · requis · US | CA | BR | MX | AU | NZ | SG | JP
    Countries outside the EU, as ISO codes: US = the United States, CA = Canada, BR = Brazil, MX = Mexico, AU = Australia, NZ = New Zealand, SG = Singapore, JP = Japan, KR = South Korea. FAOSTAT annual producer (farm-gate) prices: one figure per country, product and year, usually one to two years old.
  • product · string · requis
    The crop or animal product, e.g. 'wheat', 'maize', 'rice', 'soybeans', 'potatoes', 'tomatoes', 'apples', 'bananas', 'beef', 'pork', 'chicken', 'eggs', 'milk', 'coffee', 'cotton'. US, CA, BR, MX, AU, NZ, SG, JP, KR (FAOSTAT; KR has few products): the crop or animal product, by everyday name: wheat, maize (corn), rice, barley, soybeans, potatoes, tomatoes, apples, bananas, oranges, beef, pork, chicken, eggs, milk, coffee, cotton and many more. Annual price per tonne in the country's own currency (and in US dollars where FAO gives it), also per kg. Not every country has every product: the answer lists what is available.

  Exemple d'appel

  {"name": "pricepaid_producer_prices", "arguments": {"country": "US", "product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_rent_prices≈ 5022 tokens

  Use this when a user asks what rent tenants actually pay or have agreed for a home in a town, area or postcode, how much it costs to rent a flat, house or room there, or how rents compare, in New South Wales, Australia (country AU), Canada (country CA), Catalonia, Spain (country ES), France (country FR), England and Wales (country GB), Hong Kong (country HK), Ireland (country IE), Norway (country NO), New Zealand (country NZ), Portugal (country PT), Sweden (country SE), Singapore public housing (country SG) or Taiwan (country TW). These are rents actually agreed or paid, taken from official records and statistics: registered tenancies, rental bond lodgements, approved rentals, or official rent statistics built from administrative records of tenancies. Where the source holds individual rents the answer is a median with a typical range (10th–90th percentile) and the number of rents; where the source publishes an average or median (price_type official_statistic) the range fields are null and there is no sample size. Every answer states its unit (rent per month or per week, in the local currency), the period covered, a confidence label, and the official source and licence. How fresh: New South Wales, Australia: monthly; a month's lodgements are published in the first days of the next month; Canada: annual: the October survey is released in the months after it (the October 2025 figures were released on 17 December 2025), and every answer states its survey month; Catalonia, Spain: quarterly; latest published quarter Q1 2026 (dataset updated 30 July 2026); France: annual; the 2025 results were published in October 2026; England and Wales: monthly; each release adds a month about six weeks after it ends (the ONS labels these official statistics in development); Hong Kong: monthly, about 6 weeks after the month ends; the newest three months are provisional; Ireland: quarterly; a quarter is published about five months after it ends; Norway: annual; the 2025 survey was published on 22 December 2025; New Zealand: monthly; the files run about two months behind (the October 2026 files end in August 2026) and the latest month can still change; Portugal: quarterly, published about three months after the quarter ends (the 2nd Quarter 2026 figures were released on 29 September 2026); each answer states its quarter; Sweden: annual; the 2026 survey (rents at the start of 2026) was published on 2 October 2026; Singapore public housing: monthly; the previous month's approvals appear in the first days of the next month; Taiwan: the Ministry publishes every 10 days (the 1st, 11th and 21st); a tenancy appears about one to two months after the contract date. Our collector re-reads the releases daily, and answers cover whole calendar months ending at least 30 days before the newest contract in the register. Do not use for asking rents or listings, holiday lets, commercial rent, rent for a specific address, home sale prices, or other countries.

  Paramètres, retour & exemple (11)

  Paramètres

  • town · string · optionnel
    Town, city or local area. AU: use 'NSW' for the whole state; otherwise give a postcode (NSW rents are published by postcode). CA: required. A town or city of 10,000 people or more, e.g. Toronto, Montréal (or Montreal), Vancouver, Calgary, Edmonton, Ottawa, Winnipeg, Halifax. Add the province to be exact ('London, Ontario'). ES: required; a Catalan municipality, e.g. 'Barcelona', 'Sabadell', 'Girona' (Spanish or Catalan spelling). FR: required. An observed agglomeration: 'Paris' (the city), 'Ile-de-France' (Paris agglomeration), 'Marseille', 'Toulouse', 'Nantes', 'Rennes', 'Strasbourg', 'Bordeaux', 'Montpellier' (about 50 areas; Lyon and Lille are not observed). A name that is not observed returns the full list. GB: required. A local authority (Manchester, Leeds, Camden, Cardiff), an English region (London, North West) or England / Wales. Towns and postcodes are not published; Bristol, Hull etc. match their council area. HK: required. A region: 'Hong Kong' (Hong Kong Island), 'Kowloon' or 'New Territories'; a known district such as Mong Kok, Central or Sha Tin gives its region's figure. IE: required. A county ('Dublin', 'Cork'), a town ('Swords, Dublin', 'Galway City') or a Dublin district ('Dublin 6'). NO: required. A price zone: 'Norway' (whole country), 'Oslo', 'Akershus', 'Bergen', 'Trondheim', 'Stavanger', 'large towns', 'medium towns' or 'small towns'. NZ: required. A territorial authority or city ('Wellington', 'Auckland', 'Christchurch', 'Hamilton', 'Dunedin', 'Queenstown-Lakes'), a region ('Canterbury', 'Wellington Region') or 'New Zealand' for the whole country. A name that is both a city and a region (Wellington) gives the city. PT: any municipality ('Lisboa' / 'Lisbon', 'Porto', 'Cascais', 'Faro', 'Funchal', 'Coimbra' ... all 308) or a region ('Algarve', 'Grande Lisboa', 'Madeira', 'Açores'). Omit for Portugal as a whole. Official INE median monthly rent per m² of new leases of the last 12 months (not per home). SE: optional region group: 'Sweden' (default), 'Greater Stockholm', 'Greater Gothenburg', 'Greater Malmo', 'large municipalities' or 'small municipalities'. SG: required, an HDB town such as 'Tampines', 'Bedok' or 'Toa Payoh'. TW: a city or county in English or Chinese ('Taipei' / '台北市' / '臺北市', 'New Taipei', 'Taichung', 'Kaohsiung', 'Tainan', 'Taoyuan', 'Hsinchu City', 'Hsinchu County'), or a district with its city ("Da'an, Taipei", '臺北市大安區', 'Banqiao, New Taipei'). Omit for all of Taiwan. A district name used in several cities ('Zhongzheng', 'Dongqu') needs the city too.
  • rooms · integer · optionnel
    NO only: number of rooms (living rooms plus bedrooms), 1 to 5 (5 means five or more). Required for Norway.
  • months · integer · optionnel
    How many recent months to include, for sources that hold individual rents. Ignored by sources that publish one figure per quarter or month. AU: 3 or 12 (anything up to 4 uses the latest 3 months, longer uses 12). By default the latest 3 months, widening to 12 when a postcode is quiet. CA: ignored; the figure is for the newest October survey. ES: ignored; the figure is for the latest published quarter. FR: ignored; the figure is for the latest year published. GB: ignored; the figure is for the latest month published. HK: ignored; the answer is the newest usable month, with the last 12 months in extra. IE: ignored; the figure is for the latest quarter published. NO: ignored; the figure is for the latest year published. NZ: ignored; the figure is for the latest month MBIE has published (about two months behind). PT: ignored; INE publishes one median per quarter, covering the 12 months to the quarter's end (the latest is returned). SE: ignored; the figure is for the latest year published. SG: window of recent months, 1 to 36. Default 12. TW: 12 or 24 whole calendar months; up to 18 gives 12 (24 if a place has too few tenancies in 12), more gives 24. The window ends at the last month that is at least 30 days old.
  • country · string · requis · AU | CA | ES | FR | GB | HK | IE | NO
    AU = Australia, New South Wales only (rental bonds); CA = Canada (CMHC Rental Market Survey, average rents of purpose-built rental units, official statistic); ES = Spain (Catalonia only: INCASOL registered lease deposits); FR = France (observed rents in about 50 agglomerations, local rent observatories); GB = England and Wales (ONS average private rents; Scotland and Northern Ireland are not covered); HK = Hong Kong (Rating and Valuation Department, average rents of private domestic flats by class and region, official statistic); IE = Ireland (registered tenancies, Residential Tenancies Board); NO = Norway (Statistics Norway rental market survey); NZ = New Zealand (rental bond data from MBIE Tenancy Services; weekly rent in NZD); PT = Portugal (official INE median rent per m² per month of new leases, quarterly, by region and all 308 municipalities); SE = Sweden (Statistics Sweden rent survey); SG = Singapore HDB public-housing flats; TW = Taiwan (Ministry of the Interior actual price registration of rentals: every declared residential tenancy, summarised by city or county and district)
  • tenancy · string · optionnel · all | new | existing
    FR only: all leases (default), new = leases signed in the last year (what a new tenant faces), existing = leases of one year or more. New leases are published per dwelling type, not per size.
  • bedrooms · integer · optionnel
    Number of bedrooms (0 = studio). Leave out for all sizes. AU: 0 (studio), 1, 2, 3 or 4 (4 means four or more). CA: 0 (bachelor), 1, 2 or 3 (three or more). Leave out for two bedrooms, CMHC's usual headline size; the answer lists every size. ES: not used. FR: 0 (studio) to 3 or more; leave out for all sizes. France counts rooms including the living room, so 1 bedroom = 2 rooms (T2). GB: 1, 2, 3 or 4 (4 means four or more); leave out for all sizes. Studios are not published. Not together with property_type. HK: ignored; the RVD groups flats by saleable area. Use flat_class (A under 40 m², B 40–69.9, C 70–99.9, D 100–159.9, E 160+). Default B. IE: 1, 2, 3 or 4 (4 means four or more); leave out for all sizes. Studios are not published. NO: not used; use rooms instead (Norway counts rooms). NZ: not applied. MBIE publishes bedroom splits only by unnamed Statistics NZ area codes, not by place name; the answer says so. PT: not supported (INE does not split by bedrooms). SE: required; give the number of ROOMS (Sweden counts rooms, not bedrooms): 1, 2, 3 or 4 (4 means four or more). SG: ignored; HDB counts rooms, not bedrooms. Use flat_type ('4-ROOM'). TW: 0 (studio or open-plan) to 4; 5 means five or more. Leave out for all sizes. Not for rooms.
  • postcode · string · optionnel
    Postcode, for a precise area. AU: a four-digit NSW postcode, e.g. 2000 (Sydney CBD), 2150 (Parramatta), 2500 (Wollongong). CA: not used; give a town. ES: not used. FR: not used; give the agglomeration as town. GB: not used (rents are published by local authority); give the area name in town. HK: not used (Hong Kong has no postcodes); give a region. IE: not used (Eircodes are not published); give a town. NO: not used; give a price zone as town. NZ: not used; rents are published by territorial authority and region. PT: not supported (INE publishes by region and municipality); give the municipality as town. SE: not used. SG: not used; give an HDB town. TW: not supported (the register has no postcodes); give the city, county or district as town.
  • flat_type · string · optionnel
    SG only: HDB flat type, one of 1-ROOM, 2-ROOM, 3-ROOM, 4-ROOM, 5-ROOM, EXECUTIVE ('4 ROOM' also works). Leave out for all types.
  • flat_class · string · optionnel
    HK only: RVD flat class by saleable area, A (under 40 m²), B (40–69.9), C (70–99.9), D (100–159.9) or E (160 and over). Default B.
  • house_type · string · optionnel · detached | semi-detached | terraced
    Kind of house, for sources that publish houses by type (needed with property_type house there). CA: not used (houses are not published). GB: detached, semi-detached or terraced; required with property_type house. HK: not used. IE: detached, semi-detached or terraced; required with property_type house. NZ: not applied (see property_type). TW: not available (the register does not say detached / semi-detached / terraced); use property_type house.
  • property_type · string · optionnel · any | apartment | flat | house | room
    Kind of home: apartment (same as flat), house or room. Default 'any'. AU: apartment (flat or unit), house (includes terraces, townhouses and semi-detached) or any. Rooms are not published. CA: apartment (or flat) means apartment buildings of three or more units; leave out for rows and apartments of three or more units. Houses and rooms are not published. ES: not used (all homes together). FR: apartment (flat), house or leave out for all homes. Single rooms are not published. GB: apartment (flat) or house; leave out for all homes. For house, also give house_type. Rooms are not published. Not together with bedrooms. HK: ignored; private domestic flats only. Use flat_class for the size. IE: apartment (flat) or house; leave out for all homes. For house, also give house_type. Rooms are not published. NO: not used (the survey does not split by home type). NZ: not applied. The published place files do not split by dwelling type; the answer covers all new private tenancies and says so. PT: INE publishes one figure for all dwellings; only 'any' has an answer. SE: not used (flats in rented buildings). SG: ignored; every record is an HDB flat. Use flat_type for the size. TW: any (whole homes and self-contained studios), apartment, house (透天厝) or room (a room let separately in a shared home: 分租套房, 分租雅房; kept apart from every other figure).

  Exemple d'appel

  {"name": "pricepaid_rent_prices", "arguments": {"country": "AU"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_tuition_fees≈ 2922 tokens

  Use this when a user asks what a university or college charges students per year (tuition or registration fees for a bachelor's or master's degree) in Canada (country CA), Europe (country BE), Europe (country BG), Europe (country CZ), Europe (country DK), Europe (country DE), Europe (country EE), Europe (country IE), Europe (country GR), Europe (country ES), Europe (country FR), Europe (country HR), Europe (country IT), Europe (country CY), Europe (country LV), Europe (country LT), Europe (country LU), Europe (country HU), Europe (country MT), Europe (country NL), Europe (country AT), Europe (country PL), Europe (country PT), Europe (country RO), Europe (country SI), Europe (country SK), Europe (country FI), Europe (country SE), Europe (country AL), Europe (country BA), Europe (country CH), Europe (country IS), Europe (country LI), Europe (country ME), Europe (country MK), Europe (country NO), Europe (country RS) or Europe (country TR), or how fees compare between countries or between home and international students. Returns the official statutory fee levels published for a country and academic year: the most common annual fee, the minimum and the maximum, in national currency with a euro equivalent. These are posted fee levels set by law or by universities, not what any one student paid and not a range built from sales: there is no sample size. How fresh: Canada: annual: one value per academic year (2026/2027 was published on 16 September 2026); every answer names its academic year; Europe: academic year 2023/24 (Eurydice release of September 2025); updated about once a year. Fees are before grants, loans and fee waivers. Do not use for the price of one named course or university, living costs or rent, school fees, or countries that are not listed.

  Paramètres, retour & exemple (6)

  Paramètres

  • cycle · string · optionnel · first | second
    Degree level: first = bachelor's (first cycle, the default), second = master's (second cycle). Also accepts bachelor, master, undergraduate, postgraduate. Canada, Statistics Canada: first = undergraduate (default), second = graduate (master's and doctorate). Europe, Eurydice: first = bachelor's (default), second = master's.
  • country · string · requis · CA | BE | BG | CZ | DK | DE | EE | IE
    CA = Canada (Statistics Canada: average posted tuition fees of publicly funded universities, by province, Canadian or international students, undergraduate or graduate); European countries as ISO codes (GR for Greece): BE = Belgium, BG = Bulgaria, CZ = Czechia, DK = Denmark, DE = Germany, EE = Estonia, IE = Ireland, GR = Greece, ES = Spain, FR = France, HR = Croatia, IT = Italy, CY = Cyprus, LV = Latvia, LT = Lithuania, LU = Luxembourg, HU = Hungary, MT = Malta, NL = Netherlands, AT = Austria, PL = Poland, PT = Portugal, RO = Romania, SI = Slovenia, SK = Slovakia, FI = Finland, SE = Sweden, AL = Albania, BA = Bosnia and Herzegovina, CH = Switzerland, IS = Iceland, LI = Liechtenstein, ME = Montenegro, MK = North Macedonia, NO = Norway, RS = Serbia, TR = Turkey
  • province · string · optionnel
    Canada only: a province (Ontario, Quebec, BC, Alberta ...) or leave out for the Canada average. Yukon is mostly not published; the other territories are not in the table.
  • community · string · optionnel
    BE only: the higher-education system, because Belgium has three with different fees: fr (French Community), nl (Flemish Community) or de (German-speaking Community).
  • study_mode · string · optionnel · full-time | part-time
    full-time (the default) or part-time. Canada: full-time only (the default). Europe, Eurydice: full-time (default) or part-time.
  • student_group · string · optionnel · home | international | non-state-subsidised | specific-discipline | foreign-language
    Who pays: home (nationals and EU students who pay home fees, the default), international (students from outside the EU/EEA), non-state-subsidised (self-financed places), specific-discipline (for example medicine), foreign-language (courses taught in another language). Canada, Statistics Canada: home = Canadian citizens and permanent residents (default) or international. Other groups are not published. Europe, Eurydice: home (default), international (non-EU/EEA), non-state-subsidised, specific-discipline, foreign-language. Not every group exists in every country: the answer says when a fee is not available.

  Exemple d'appel

  {"name": "pricepaid_tuition_fees", "arguments": {"country": "CA"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_wholesale_fresh_food_prices≈ 2438 tokens

  Use this when a user asks what the wholesale price of live pigs, cattle or chickens, fish, eggs or other fresh food is today in England and Wales (country GB) or Hong Kong (country HK), or how it moved on the previous day. Returns the newest daily average reference wholesale price that the government publishes for the food type, per kilogram or per egg, with the day it applies to, the change on the previous published day, the recent days, the official source and licence. This is a posted reference price reported by wholesalers (price_type posted_price), not a paid price and not a range built from sales, so the range fields are null and there is no sample size. How fresh: England and Wales: about every two weeks (a Monday date); each answer states the date its price applies to; Hong Kong: daily on working days, published by the AFCD when necessary; each answer states the day its price applies to. Do not use for supermarket or shop prices, for the price one farm received, for restaurant prices, for futures prices, or for other countries.

  Paramètres, retour & exemple (2)

  Paramètres

  • country · string · requis · GB | HK
    GB = England and Wales (DEFRA average wholesale prices of home-grown fruit and vegetables at the Birmingham, Bristol, Manchester and London markets, quoted not paid, about every two weeks); HK = Hong Kong (AFCD daily average reference wholesale prices of fresh food, posted by wholesalers, not paid prices)
  • product · string · requis
    The food in plain words, e.g. 'live pig', 'chicken', 'eggs', 'grass carp', 'tomato'. The list for each country is in the tool notes. GB: home-grown fruit and vegetables: apples (gala, bramley, cox...), pears, plums, strawberries, raspberries, blackberries, blueberries, cherries, gooseberries, currants, carrots, onions, leeks, cauliflower, cabbage, calabrese, lettuce, tomatoes, cucumbers, courgettes, capsicum, beans, peas, beetroot, parsnips, swede, turnip, sprouts, celery, rhubarb, kale and more (no potatoes). An item with several varieties gives the mean of the varieties and lists each; add the variety (for example 'gala apples') for one price. Prices are GBP per kg, per head, per twin pack or per stem; the answer names the unit and the date. HK: live pig, live cattle, live chicken (local or mainland), eggs (mainland, USA, Germany), marine fish (golden thread, yellow croaker, mackerel, hairtail...), freshwater fish (grass carp, big head, mud carp) and vegetables (tomato, potato, broccoli, spinach, cabbage, Chinese kale, celery...). Prices are HK$ per kg (converted from per catty) or HK$ per egg; the answer names the unit and the day.

  Exemple d'appel

  {"name": "pricepaid_wholesale_fresh_food_prices", "arguments": {"country": "GB", "product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_wholesale_market_prices≈ 2376 tokens

  Use this when a user asks what traders paid for vegetables or fruit (cabbage, tomatoes, cucumbers, onions, bananas, pineapples, guavas, melons, grapes...) at the wholesale produce markets of Taiwan (country TW), or what the price range at the wholesale market was this week. Returns a range built from the market's own daily trading records (median, 10th to 90th percentile, lowest and highest, number of records) for the newest few days, per kilogram, with the volume traded, the markets included and the official source and licence. A record is the average price of one variety at one market on one day. How fresh: daily, trading days only (a closed market publishes nothing). These are wholesale prices between traders, not what a shopper pays and not what a farmer receives. Do not use for supermarket or shop prices, for the price one farm received, for flowers, meat or fish, for futures prices, or for other countries.

  Paramètres, retour & exemple (3)

  Paramètres

  • market · string · optionnel
    One wholesale market, only where the source publishes by market (for example a city name). Leave out for all markets together. TW: optional wholesale market: taipei, banqiao, sanchong, yilan, taoyuan, taichung, fengyuan, xihu, xiluo, chiayi, dongshi, kaohsiung, fengshan, pingtung, taitung, hualien, tainan, changhua (or the Taiwanese name such as 西螺). Leave out for all markets together. Not every market trades every product.
  • country · string · requis · TW
    TW = Taiwan (daily trading averages at the wholesale vegetable and fruit markets)
  • product · string · requis
    The vegetable or fruit in plain words, e.g. 'cabbage', 'tomato', 'banana', 'pineapple'. The local-language name also works. The full list is in the tool notes. TW: required. Vegetable or fruit by English name or Taiwanese name, in NT$ per kg: cabbage, chinese cabbage, pak choi, water spinach, celery, cauliflower, broccoli, cucumber, luffa, bitter gourd, wax gourd, eggplant, tomato, cherry tomato, bell pepper, chili, green beans, peas, corn, radish, carrot, onion, spring onion, sweet potato, potato, taro, bean sprouts, gai lan, banana, pineapple, ponkan, orange, lemon, grapefruit, pomelo, watermelon, melon, papaya, guava, wax apple, grapes, apple, pear, persimmon, dragon fruit, avocado, kiwi, sugar apple, passion fruit, coconut. Imported produce is left out unless fewer than 5 domestic records exist.

  Exemple d'appel

  {"name": "pricepaid_wholesale_market_prices", "arguments": {"country": "TW", "product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

• pricepaid_wholesale_power_prices≈ 2359 tokens

  Use this when a user asks what electricity costs on the wholesale (day-ahead power exchange) market in Germany or Austria, Belgium, Denmark, France, northern Italy, the Netherlands, south-west Norway and Poland: the recent median, the typical range across hours, the cheapest and dearest hour, the latest hour and how many hours had negative prices. Prices are in euro per MWh (1 MWh = 1000 kWh; the answer also gives cents per kWh). Built from the hourly auction prices of the recent days, with the official source and licence. How fresh: Germany: hourly prices, published the day before delivery (around 13:00 Central European Time); ProofPrice reads them on each request (cached up to 30 minutes); Austria, Belgium, Denmark, France, northern Italy, the Netherlands, south-west Norway and Poland: prices are published the day before delivery (around 13:00 Central European Time); ProofPrice reads them on each request (cached up to 30 minutes). Wholesale prices are not what households or businesses pay on their bills. Do not use for retail tariffs, for petrol and diesel, or for other countries.

  Paramètres, retour & exemple (4)

  Paramètres

  • zone · string · optionnel
    Bidding zone, only where a country has more than one: DK = DK1 (west, default) or DK2 (east). IT answers northern Italy (IT-North), NO south-west Norway (NO2); other countries have one zone.
  • market · string · optionnel · day-ahead
    Which wholesale market. Only day-ahead (the next-day hourly auction) is available. DE: day-ahead only (the hourly auction held the day before delivery). AT/BE/DK/FR/IT/NL/NO/PL: day-ahead only (the auction held the day before delivery).
  • country · string · requis · DE | AT | BE | DK | FR | IT | NL | NO
    DE = Germany (Germany/Luxembourg bidding zone, SMARD day-ahead hourly auction prices); Day-ahead wholesale power for AT = Austria, BE = Belgium, DK = Denmark, FR = France, IT = Italy, NL = the Netherlands, NO = Norway, PL = Poland (Germany is DE, served separately)
  • lookback_days · integer · optionnel
    How many recent days of hourly prices to include. Default 7, at most 14. DE: 1 to 14 days of hourly prices (default 7); each hour counts as one record. AT/BE/DK/FR/IT/NL/NO/PL: 1 to 14 days of hourly average prices (default 7); each hour counts as one record.

  Exemple d'appel

  {"name": "pricepaid_wholesale_power_prices", "arguments": {"country": "DE"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"as_of": "texte", "extra": {}, "price": "texte", "query": {}, "method": "texte", "notice": "texte", "period": {}, "source": {}, "status": "ok", "summary": "texte", "evidence": {}, "answer_id": "texte"}}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://proofprice.com/api/mcp