{"uid":"cap_IHLHOoRPtoVA0ZeB773dr","slug":"spanish-fuel-prices-by-province-072225d4","name":"Spanish Fuel Prices by Province","description":"Average, minimum and maximum price of a fuel in every Spanish province right now, from cheapest to most expensive, with the national average. Official Ministry data updated every 30 minutes.","url":"https://api.vextorium.com/carburantes-provincias-pago?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":[],"properties":{"carburante":{"enum":["gasolina95","gasolina98","diesel","diesel_premium","glp","gnc","adblue","hidrogeno"],"type":"string"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":["object","null"],"properties":{"fuente":{"type":["string","null"]},"carburante":{"type":["string","null"]},"provincias":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"media":{"type":["null","number"]},"maximo":{"type":["null","number"]},"minimo":{"type":["null","number"]},"provincia":{"type":["null","string"]},"estaciones":{"type":["null","number"]}}}},"actualizado":{"type":["string","null"]},"media_nacional":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"fuente":"Ministerio para la Transición Ecológica (Geoportal de carburantes)","carburante":"diesel","provincias":[{"media":1.565,"maximo":1.567,"minimo":1.555,"provincia":"Melilla","estaciones":12},{"media":1.673,"maximo":1.819,"minimo":1.527,"provincia":"Palmas (Las)","estaciones":252}],"actualizado":"02/10/2026 17:21:04","media_nacional":1.915}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZnXbw8VgySLSUP4NaEGwD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns average, minimum, and maximum fuel prices for every Spanish province, sorted cheapest to most expensive, plus the national average — updated every 30 minutes from official Ministry data.","exampleAgentPrompt":"What are the current diesel prices across all Spanish provinces right now — show me the average, minimum, and maximum for each one, sorted from cheapest to most expensive?","exampleUseCases":[{"title":"Finding cheapest province for a road trip fill-up","prompt":"I'm driving across Spain next week — which province currently has the cheapest gasolina 95 and which has the most expensive? Show me the full ranking with average prices."},{"title":"Monitoring national average diesel price","prompt":"What's the national average diesel price in Spain right now, and which provinces are pulling it up or down the most?"},{"title":"Comparing LPG availability and prices by province","prompt":"Can you pull the current GLP prices for every Spanish province and tell me where it's cheapest and how many stations are offering it?"}],"resultDescription":"A JSON object containing the fuel type queried, the data source (Ministry), the last update timestamp, the national average price, and an array of all Spanish provinces each with their average, minimum, and maximum price for that fuel and the number of stations sampled — sorted from cheapest to most expensive average.","failureModes":["Invalid or unsupported fuel type enum value returns an error","Ministry data source temporarily unavailable may cause stale or missing data","Missing required 'carburante' field in body causes a validation error","Network timeout if upstream Ministry API is slow to respond"],"whenToPreferThis":"Use this endpoint when you need official, near-real-time (30-minute refresh) fuel price data for all Spanish provinces simultaneously, covering all major fuel types including GLP, GNC, and hydrogen. Prefer this over general search or scraping when you need structured, comparable province-level statistics (avg/min/max) sourced directly from the Spanish Ministry.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:44:41.498Z","isFirstParty":false,"canonicalSlug":"spanish-fuel-prices-by-province-072225d4"}