# AAA API: Get gas prices

> 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.

Unofficial. Not affiliated with or endorsed by AAA.

- Page: https://fous.com/methods/gasprices.aaa.com/get-gas-prices
- Method: `gasprices.aaa.com/get_gas_prices`, version 1
- Website: gasprices.aaa.com
- Returns: place, price date, current, yesterday, week-ago, month-ago and year-ago prices by grade, record highs for regular and diesel, AAA link
- 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 | no | `"Houston, TX"` | US, a state name or two-letter code, or a metro name followed by its state, for example Houston, TX. Default "US". |

## Output

From a run on Oct 31, 2026. Its input:

```json
{
  "location": "Houston, TX"
}
```

Its output:

```json
{
  "date": "2026-09-28",
  "link": "https://gasprices.aaa.com/?state=TX#state-metro",
  "place": "Houston, TX",
  "current": {
    "diesel": 5.8545,
    "premium": 4.9246,
    "regular": 3.9152,
    "mid_grade": 4.503
  },
  "currency": "USD",
  "week_ago": {
    "diesel": 5.8904,
    "premium": 4.8859,
    "regular": 3.8783,
    "mid_grade": 4.4543
  },
  "year_ago": {
    "diesel": 3.1334,
    "premium": 3.678,
    "regular": 2.6726,
    "mid_grade": 3.2715
  },
  "month_ago": {
    "diesel": 5.1073,
    "premium": 4.5727,
    "regular": 3.5428,
    "mid_grade": 4.1367
  },
  "yesterday": {
    "diesel": 5.866,
    "premium": 4.9346,
    "regular": 3.9199,
    "mid_grade": 4.5048
  },
  "record_high_diesel": {
    "date": "2026-09-23",
    "price": 5.8996
  },
  "record_high_regular": {
    "date": "2022-06-11",
    "price": 4.6821
  }
}
```

## 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":"gasprices.aaa.com/get_gas_prices","input":{"location":"Houston, TX"}}'
```

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

- What's the national average price for regular gas today, and how does it compare to a year ago?
- Check AAA for current diesel prices in Ohio, including the record high
- How much is premium gas in Denver, CO right now versus last week and last month?
- Pull the aaa.com average fuel prices for the Phoenix, AZ metro area by grade
- Has the average price of gas in California gone up since yesterday? Show me the mid-grade and regular numbers.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "location": {
      "type": "string",
      "default": "US",
      "description": "US, a state name or two-letter code, or a metro name followed by its state, for example Houston, TX."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "place",
    "date",
    "currency",
    "current",
    "yesterday",
    "week_ago",
    "month_ago",
    "year_ago",
    "record_high_regular",
    "record_high_diesel",
    "link"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "AAA price date (YYYY-MM-DD)."
    },
    "link": {
      "type": "string",
      "description": "AAA price page for this location."
    },
    "place": {
      "type": "string",
      "description": "The national, state, or metro location."
    },
    "current": {
      "type": "object",
      "required": [
        "regular",
        "mid_grade",
        "premium",
        "diesel"
      ],
      "properties": {
        "diesel": {
          "type": [
            "number",
            "null"
          ],
          "description": "Diesel price per gallon in USD."
        },
        "premium": {
          "type": [
            "number",
            "null"
          ],
          "description": "Premium price per gallon in USD."
        },
        "regular": {
          "type": [
            "number",
            "null"
          ],
          "description": "Regular price per gallon in USD."
        },
        "mid_grade": {
          "type": [
            "number",
            "null"
          ],
          "description": "Mid-grade price per gallon in USD."
        }
      },
      "description": "Current average prices per gallon in USD.",
      "additionalProperties": false
    },
    "currency": {
      "type": "string",
      "description": "Currency of all prices, USD."
    },
    "week_ago": {
      "type": "object",
      "required": [
        "regular",
        "mid_grade",
        "premium",
        "diesel"
      ],
      "properties": {
        "diesel": {
          "type": [
            "number",
            "null"
          ],
          "description": "Diesel price per gallon in USD."
        },
        "premium": {
          "type": [
            "number",
            "null"
          ],
          "description": "Premium price per gallon in USD."
        },
        "regular": {
          "type": [
            "number",
            "null"
          ],
          "description": "Regular price per gallon in USD."
        },
        "mid_grade": {
          "type": [
            "number",
            "null"
          ],
          "description": "Mid-grade price per gallon in USD."
        }
      },
      "description": "One week ago average prices per gallon in USD.",
      "additionalProperties": false
    },
    "year_ago": {
      "type": "object",
      "required": [
        "regular",
        "mid_grade",
        "premium",
        "diesel"
      ],
      "properties": {
        "diesel": {
          "type": [
            "number",
            "null"
          ],
          "description": "Diesel price per gallon in USD."
        },
        "premium": {
          "type": [
            "number",
            "null"
          ],
          "description": "Premium price per gallon in USD."
        },
        "regular": {
          "type": [
            "number",
            "null"
          ],
          "description": "Regular price per gallon in USD."
        },
        "mid_grade": {
          "type": [
            "number",
            "null"
          ],
          "description": "Mid-grade price per gallon in USD."
        }
      },
      "description": "One year ago average prices per gallon in USD.",
      "additionalProperties": false
    },
    "month_ago": {
      "type": "object",
      "required": [
        "regular",
        "mid_grade",
        "premium",
        "diesel"
      ],
      "properties": {
        "diesel": {
          "type": [
            "number",
            "null"
          ],
          "description": "Diesel price per gallon in USD."
        },
        "premium": {
          "type": [
            "number",
            "null"
          ],
          "description": "Premium price per gallon in USD."
        },
        "regular": {
          "type": [
            "number",
            "null"
          ],
          "description": "Regular price per gallon in USD."
        },
        "mid_grade": {
          "type": [
            "number",
            "null"
          ],
          "description": "Mid-grade price per gallon in USD."
        }
      },
      "description": "One month ago average prices per gallon in USD.",
      "additionalProperties": false
    },
    "yesterday": {
      "type": "object",
      "required": [
        "regular",
        "mid_grade",
        "premium",
        "diesel"
      ],
      "properties": {
        "diesel": {
          "type": [
            "number",
            "null"
          ],
          "description": "Diesel price per gallon in USD."
        },
        "premium": {
          "type": [
            "number",
            "null"
          ],
          "description": "Premium price per gallon in USD."
        },
        "regular": {
          "type": [
            "number",
            "null"
          ],
          "description": "Regular price per gallon in USD."
        },
        "mid_grade": {
          "type": [
            "number",
            "null"
          ],
          "description": "Mid-grade price per gallon in USD."
        }
      },
      "description": "Yesterday average prices per gallon in USD.",
      "additionalProperties": false
    },
    "record_high_diesel": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "price",
        "date"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Date the record was reached (YYYY-MM-DD)."
        },
        "price": {
          "type": "number",
          "description": "Record-high average price per gallon in USD."
        }
      },
      "description": "Highest recorded average price per gallon in USD and the date it occurred, if AAA shows it.",
      "additionalProperties": false
    },
    "record_high_regular": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "price",
        "date"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Date the record was reached (YYYY-MM-DD)."
        },
        "price": {
          "type": "number",
          "description": "Record-high average price per gallon in USD."
        }
      },
      "description": "Highest recorded average price per gallon in USD and the date it occurred, if AAA shows it.",
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
```

## 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.
- [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.
- [GasBuddy API: List cheapest gas stations](https://fous.com/methods/gasbuddy.com/list-cheapest-gas-stations.md): 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.
- [EIA API: Get electricity prices](https://fous.com/methods/eia.gov/get-electricity-prices.md): Gets a state's latest monthly electricity price for a customer type from EIA. It also returns the year-over-year change, the year-to-date average and the matching US average.
- [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.
- [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.
- [Zumper API: Get average rents by city](https://fous.com/methods/zumper.com/get-average-rents.md): Gets Zumper's current median monthly rents for studio through three-bedroom homes in a city, with monthly and yearly percentage changes. National rank is included only when the same-month U.S. national report ranks the city.
- [FuelEconomy.gov API: Get fuel economy](https://fous.com/methods/fueleconomy.gov/get-fuel-economy.md): Returns official MPG or MPGe, range, annual fuel cost, five-year savings and emissions for every matching version of a vehicle. Costs use current fuel prices and 15,000 miles per year; plug-in hybrid costs include gasoline and electricity.