Live fuel prices at the pump
pricepaid_fuel_prices_nowRead-onlyIdempotent
Use this when a user asks the current price of petrol, diesel, E10, E85, LPG or CNG near a place in Spain, France or Italy, 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: Spain: several times a day; France: about every 10 minutes; Italy: daily (prices at 08:00 of the extraction day). Do not use for other countries or for historical prices.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| area | No | Wider area when no postcode. ES: province code ('28' = Madrid). FR: department ('69', '2A'). IT: province ('MI', 'RM'). | |
| fuel | Yes | petrol95 = unleaded 95; methane = CNG (priced per kg). Italy: diesel, petrol95, lpg, methane only. | |
| town | No | Town name. ES: town name, e.g. 'Valencia'. IT: comune name, e.g. 'Bologna'. | |
| country | Yes | ES = Spain; FR = France; IT = Italy | |
| service | No | Self-service or attended service, where a country prices them differently. IT: self-service (default) or attended service, which costs more. | |
| postcode | No | Postcode of the place. ES: 5-digit postcode, e.g. '28001'. FR: 5-digit postcode, e.g. '75015'. |