{"uid":"cap_i3fyaWrbJqIDOgFp-gHeP","slug":"vextorium-spain-petrol-station-price-finder-349cf3c2","name":"Vextorium Spain Petrol Station Price Finder","description":"Cheapest petrol stations in Spain for a fuel (gasoline 95/98, diesel, LPG, CNG, AdBlue, hydrogen) by town, province or near coordinates: price, brand, address, opening hours and distance, plus the area's average. Official Ministry prices, updated every 30 minutes.","url":"https://api.vextorium.com/gasolineras-espana-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":{"limite":{"type":"integer","description":"Stations (1-50, default 10)"},"latitud":{"type":"number"},"longitud":{"type":"number"},"radio_km":{"type":"number","description":"Search radius around coordinates (0.5-50, default 5)"},"municipio":{"type":"string"},"provincia":{"type":"string"},"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"]},"actualizado":{"type":["string","null"]},"mas_baratas":{"type":["array","null"],"items":{"type":["null","object"],"properties":{"cp":{"type":["null","string"]},"marca":{"type":["null","string"]},"horario":{"type":["null","string"]},"latitud":{"type":["null","number"]},"longitud":{"type":["null","number"]},"direccion":{"type":["null","string"]},"municipio":{"type":["null","string"]},"provincia":{"type":["null","string"]},"distancia_km":{"type":["null","number"]},"precio_eur_litro":{"type":["null","number"]}}}},"precio_medio":{"type":["number","null"]},"precio_maximo":{"type":["number","null"]},"precio_minimo":{"type":["number","null"]},"estaciones_en_zona":{"type":["number","null"]}}}}}}},"responseSchema":{"type":"json","example":{"fuente":"Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de carburantes, datos abiertos)","carburante":"gasolina95","actualizado":"02/10/2026 17:00:33","mas_baratas":[{"cp":"28005","marca":"BALLENOIL","horario":"L-D: 24H","latitud":40.41025,"longitud":-3.717528,"direccion":"RONDA SEGOVIA, 37","municipio":"Madrid","provincia":"MADRID","distancia_km":1.37,"precio_eur_litro":1.748},{"cp":"28045","marca":"SHELL","horario":"L-D: 24H","latitud":40.397722,"longitud":-3.702472,"direccion":"PASEO SANTA MARIA DE LA CABEZA, 90","municipio":"Madrid","provincia":"MADRID","distancia_km":2.12,"precio_eur_litro":1.769},{"cp":"28010","marca":"REPSOL","horario":"L-V: 07:00-21:30; S: 08:00-15:30","latitud":40.429194,"longitud":-3.694194,"direccion":"CALLE ALMAGRO, 9","municipio":"Madrid","provincia":"MADRID","distancia_km":1.6,"precio_eur_litro":1.835}],"precio_medio":1.858,"precio_maximo":1.909,"precio_minimo":1.748,"estaciones_en_zona":23}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NRaaV64cu0SaQ1Zx91a93","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the cheapest petrol stations in Spain for a chosen fuel type near coordinates, in a town, or in a province, with prices, brand, address, opening hours, distance, and area statistics from official Ministry data.","exampleAgentPrompt":"Find me the 5 cheapest gasolina95 stations within 10 km of coordinates 40.4168, -3.7038 in Spain — I need the price, brand, address, and opening hours for each.","exampleUseCases":[{"title":"Road trip fuel stop planner","prompt":"I'm driving through Andalusia tomorrow — can you find the 10 cheapest diesel stations in the province of Sevilla so I know where to fill up?"},{"title":"Daily commuter cheapest fill-up","prompt":"What are the 3 cheapest gasolina95 stations within 5 km of latitude 41.3851, longitude 2.1734 in Spain right now, with their prices and addresses?"},{"title":"EV alternative LPG route check","prompt":"Find me the cheapest GLP stations in the municipality of Zaragoza — show me up to 15 results with price, brand, and whether they're open 24 hours."}],"resultDescription":"A JSON object containing: the cheapest stations list (up to 50) each with brand, address, postcode, municipality, province, latitude, longitude, distance in km, price in EUR/litre, and opening hours schedule; plus area-level stats (average, min, max price and total stations in zone); fuel type queried; and the official Ministry data timestamp updated every 30 minutes.","failureModes":["Missing required body fields (type, method, bodyType, body) returns a validation error","Invalid carburante enum value returns an error listing valid options","Coordinates outside Spain or no stations found in radius returns empty results","Search radius outside 0.5–50 km range may return an error or default","Limit outside 1–50 range defaults to 10 or returns validation error","Ministry API downtime may cause stale or unavailable data","Malformed JSON body returns HTTP 400"],"whenToPreferThis":"Choose this endpoint when you need real-time, official Spanish government fuel prices for a specific location, town, or province. It is the authoritative source (Ministry data, updated every 30 minutes) covering all fuel types including hydrogen, CNG, and AdBlue — unlike generic map services or non-official aggregators. Prefer it over web scraping or third-party price apps when accuracy and recency of Spanish petrol prices matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:44:50.888Z","isFirstParty":false,"canonicalSlug":"vextorium-spain-petrol-station-price-finder-349cf3c2"}