# GasBuddy API: List cheapest gas stations > Finds nearby GasBuddy stations for a US or Canadian city, address or postal code and lists their reported prices for a fuel grade, lowest listed price first. Unofficial. Not affiliated with or endorsed by GasBuddy. - Page: https://fous.com/methods/gasbuddy.com/list-cheapest-gas-stations - Method: `gasbuddy.com/list_cheapest_gas_stations`, version 1 - Website: gasbuddy.com - Returns: station name, brand, address, price, cash and credit prices, price age, rating, link, coordinates - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `location` | string | yes | `"Los Angeles, CA"` | US or Canadian city, street address, or postal code, such as Denver, CO or 90210. | | `fuel_type` | string | no | `"premium"` | Fuel grade, such as premium. Defaults to regular. One of "regular", "midgrade", "premium", "diesel". Default "regular". | | `max_results` | integer | no | `50` | Maximum number of stations, such as 20. Defaults to 20; maximum 50. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "location": "Los Angeles, CA", "fuel_type": "premium", "max_results": 50 } ``` Its output: ```json { "stations": [ { "city": "West Los Angeles", "unit": "gallon", "brand": "Speedway", "price": 6.09, "currency": "USD", "latitude": 34.050540643163, "reported": "10 Hours Ago", "longitude": -118.435224965215, "cash_price": 6.09, "price_type": "cash", "station_id": "11323", "star_rating": 4, "credit_price": 6.14, "station_link": "https://www.gasbuddy.com/station/11323", "station_name": "Speedway Express", "street_address": "10801 Santa Monica Blvd" }, { "city": "Los Angeles", "unit": "gallon", "brand": "Speedway", "price": 6.09, "currency": "USD", "latitude": 34.059134876425, "reported": "9 Hours Ago", "longitude": -118.383294716477, "cash_price": 6.09, "price_type": "cash", "station_id": "11297", "star_rating": 4.1, "credit_price": 6.19, "station_link": "https://www.gasbuddy.com/station/11297", "station_name": "Speedway Express", "street_address": "8770 W Olympic Blvd" }, { "city": "Los Angeles", "unit": "gallon", "brand": "SnacKing", "price": 6.09, "currency": "USD", "latitude": 34.058437133258, "reported": "18 Hours Ago", "longitude": -118.364059925079, "cash_price": null, "price_type": "credit", "station_id": "9922", "star_rating": 1.8, "credit_price": 6.09, "station_link": "https://www.gasbuddy.com/station/9922", "station_name": "SK Gasoline", "street_address": "6101 W Olympic Blvd" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"gasbuddy.com/list_cheapest_gas_stations","input":{"location":"Los Angeles, CA","fuel_type":"premium","max_results":50}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Where's the cheapest regular unleaded near Denver, CO right now? Give me the top 10 stations with prices. - I drive a diesel truck and I'm passing through Amarillo, TX tonight. Which stations have the lowest diesel prices, including cash vs credit? - Check GasBuddy for the cheapest premium gas around zip code 30318 and list about 15 stations with addresses and how recent the prices are. - Lowest midgrade prices close to 1200 Main St, Kansas City, MO, sorted cheapest first please. - Pull up GasBuddy prices for Calgary, AB. I want the 25 cheapest places to fill up with regular, with ratings and map coordinates. ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "description": "US or Canadian city, street address, or postal code, such as Denver, CO or 90210." }, "fuel_type": { "enum": [ "regular", "midgrade", "premium", "diesel" ], "type": "string", "default": "regular", "description": "Fuel grade, such as premium. Defaults to regular." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of stations, such as 20. Defaults to 20; maximum 50." } } } ``` ## Output schema ```json { "type": "object", "required": [ "stations" ], "properties": { "stations": { "type": "array", "items": { "type": "object", "required": [ "station_name", "brand", "street_address", "city", "price", "currency", "unit", "price_type", "cash_price", "credit_price", "reported", "star_rating", "station_link", "station_id", "latitude", "longitude" ], "properties": { "city": { "type": [ "string", "null" ], "description": "City." }, "unit": { "type": "string", "description": "gallon or litre." }, "brand": { "type": [ "string", "null" ], "description": "Fuel or store brand." }, "price": { "type": [ "number", "null" ], "description": "Listed price for the selected fuel in the stated currency and unit." }, "currency": { "type": "string", "description": "USD or CAD." }, "latitude": { "type": [ "number", "null" ], "description": "Station latitude." }, "reported": { "type": [ "string", "null" ], "description": "Approximate age of the selected price, such as 2 Hours Ago." }, "longitude": { "type": [ "number", "null" ], "description": "Station longitude." }, "cash_price": { "type": [ "number", "null" ], "description": "Cash price for the selected fuel when reported." }, "price_type": { "type": [ "string", "null" ], "description": "Cash or credit for the listed price." }, "station_id": { "type": "string", "description": "GasBuddy station ID." }, "star_rating": { "type": [ "number", "null" ], "description": "Star rating when shown." }, "credit_price": { "type": [ "number", "null" ], "description": "Credit price for the selected fuel when reported." }, "station_link": { "type": "string", "description": "GasBuddy page for the station." }, "station_name": { "type": [ "string", "null" ], "description": "Name shown for the station." }, "street_address": { "type": [ "string", "null" ], "description": "Street address." } } }, "description": "Nearby stations, lowest listed price first, stations without a price last." } } } ``` ## See more - [GasBuddy API: Get average gas prices](https://fous.com/methods/gasbuddy.com/get-average-gas-prices.md): Gets GasBuddy's latest reported average regular gas price, its changes and the diesel benchmark for a US state or a listed metro area. Midgrade, premium and area low/high prices are not published with these averages; updates may lag the current day. - [AAA API: Get gas prices](https://fous.com/methods/gasprices.aaa.com/get-gas-prices.md): Gets AAA average gasoline and diesel prices for the US, a state, or a metro area listed on its state page, with yesterday, week, month and year-ago comparisons and record highs, as of the date AAA shows. - [Costco API: Find nearby warehouses](https://fous.com/methods/costco.com/search-warehouses.md): Finds the US Costco warehouses nearest a city, address or ZIP code, with today's and weekly hours, gas station hours, services and posted gas prices. - [energy.gov API: Search EV chargers](https://fous.com/methods/afdc.energy.gov/search-ev-chargers.md): Find public, open EV charging stations near a US or Canadian city, address, or postal code, sorted by distance. Power is the highest listed connector output at each station; unavailable details are null. - [EIA API: Get weekly fuel prices](https://fous.com/methods/eia.gov/get-fuel-prices.md): Gets the latest weekly EIA retail gasoline and on-highway diesel prices for a U.S. area, with changes from the prior week and from 52 weeks earlier. - [AutoZone API: Search stores near a location](https://fous.com/methods/autozone.com/search-stores.md): Finds the AutoZone stores nearest a US ZIP code, city or street address, with contact details, opening hours, whether each is open now, distance and store page links. - [PlugShare API: Search EV chargers near a place](https://fous.com/methods/plugshare.com/search-chargers.md): Finds public PlugShare charging stations near an address, city or ZIP code, nearest first, with driver PlugScores and charging details. Cost and opening hours appear when listed. - [Zippopotam.us API: Search postal codes](https://fous.com/methods/zippopotam.us/search-postal-codes.md): Finds postal codes, place names and coordinates for a town and state or region in a country covered by Zippopotam.us. - [All GasBuddy methods](https://fous.com/methods/gasbuddy.com.md)