AAA APIgasprices.aaa.com ↗
Retrieve AAA gas and EV charging prices at national, state, and metro level. Includes historical comparisons, all-time highs, price change deltas, and news articles.
What is the AAA API?
This API exposes 13 endpoints covering AAA's national, state, and metro-level fuel price data across Regular, Mid-Grade, Premium, and Diesel grades. get_national_average returns today's prices alongside comparisons to yesterday, one week, one month, and one year ago. Other endpoints cover all 50 states plus DC, metro-area breakdowns, price change deltas, EV charging rates by state, all-time price records, and a searchable archive of AAA fuel news articles.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/8c9bd3db-a958-41a6-8e97-b4e58c80a4d6/get_national_average' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns today's AAA national average gas price for all fuel grades (Regular, Mid-Grade, Premium, Diesel) with historical comparisons to yesterday, one week ago, one month ago, and one year ago. Includes the date the prices were recorded.
No input parameters required.
{
"type": "object",
"fields": {
"date": "string, date the prices were recorded (e.g. '6/10/26')",
"prices": "object with keys Regular, Mid-Grade, Premium, Diesel each containing current, yesterday, week_ago, month_ago, year_ago prices as numbers",
"location": "string, always 'National'"
},
"sample": {
"data": {
"date": "6/10/26",
"prices": {
"Diesel": {
"current": 5.303,
"week_ago": 5.411,
"year_ago": 3.506,
"month_ago": 5.647,
"yesterday": 5.317
},
"Premium": {
"current": 5.036,
"week_ago": 5.145,
"year_ago": 3.962,
"month_ago": 5.384,
"yesterday": 5.041
},
"Regular": {
"current": 4.151,
"week_ago": 4.261,
"year_ago": 3.122,
"month_ago": 4.522,
"yesterday": 4.161
},
"Mid-Grade": {
"current": 4.662,
"week_ago": 4.77,
"year_ago": 3.605,
"month_ago": 5.011,
"yesterday": 4.663
}
},
"location": "National"
},
"status": "success"
}
}About the AAA API
Fuel Price Coverage
get_national_average returns a single-day snapshot with five time-period comparisons (current, yesterday, week_ago, month_ago, year_ago) for each of the four fuel grades. get_state_gas_prices lists all 50 states plus DC in one response, with current prices for all grades. For deeper state-level data, get_state_price_details accepts a state_code parameter and returns the same historical comparison fields plus an highest_recorded object that maps each fuel type to its all-time record price and the date it was set.
Metro and Trend Data
get_metro_prices_by_state takes a state_code and returns an array of metro objects, each carrying current and historical prices for all four grades. get_price_change_by_state and get_price_change_by_metro return signed deltas — day_change, week_change, month_change, year_change — making it straightforward to detect whether prices are rising or falling in a region. get_lowest_state_prices and get_lowest_metro_prices return pre-sorted arrays ascending by regular price, useful for cheapest-fuel queries without client-side sorting.
EV Charging and News
get_ev_charging_prices returns a flat array of locations with LOCATION_NAME, LOCATION_STATE, LOCATION_TYPE, ev_totalchargers, and ev_costperkwh. This is the only EV-specific endpoint in the set. The news surface has three endpoints: get_news_articles for paginated recent articles, get_news_article_detail for full HTML content by slug, and search_news_articles for keyword and date-range queries. search_news_articles accepts query, start_date, end_date, page, limit, and order parameters and returns total_posts, total_pages, and a has_more boolean for cursor-style pagination.
All-Time Records
get_highest_recorded_prices accepts an optional state_code. Omitting it returns national records. The response maps fuel type labels such as Regular Unleaded and Diesel to objects with price and date strings, giving a reference point for comparing current prices against historical peaks.
The AAA API is a managed, monitored endpoint for gasprices.aaa.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when gasprices.aaa.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official gasprices.aaa.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a live national fuel price widget with day-over-day and week-over-week changes using
get_national_averageresponse fields. - Build a state comparison table sorted by cheapest regular gas using
get_lowest_state_prices. - Alert users when a state's regular price delta from
get_price_change_by_statecrosses a defined threshold. - Show metro-level price rankings within a user's home state using
get_lowest_metro_prices. - Integrate EV charging cost-per-kWh by state from
get_ev_charging_pricesinto a trip-cost calculator alongside gasoline prices. - Power a fuel price history dashboard by pairing current prices with all-time highs from
get_highest_recorded_prices. - Index AAA fuel news by state name using
search_news_articleswith a state name as thequeryparameter and a date range for filtering.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does AAA publish an official developer API for its gas price data?+
What does `get_state_price_details` return beyond current prices?+
get_state_price_details returns current, yesterday, week_ago, month_ago, and year_ago prices for all four fuel grades, plus a highest_recorded object that includes the all-time record price and the date it was set for each grade in that state.How does `search_news_articles` differ from `get_news_articles`?+
get_news_articles returns recent articles in reverse-chronological order with basic pagination. search_news_articles accepts a required query string plus optional start_date and end_date filters (ISO format YYYY-MM-DD), making it the only way to retrieve older articles matching a specific keyword or state name.Does the API provide per-station or ZIP-code-level gas prices?+
get_metro_prices_by_state and get_lowest_metro_prices. There are no station-level or ZIP-code-level prices in the current endpoint set. You can fork this API on Parse and revise it to add an endpoint targeting a more granular data source.Does the EV charging data include charger network names or connector types?+
get_ev_charging_prices endpoint returns LOCATION_NAME, LOCATION_STATE, LOCATION_TYPE, ev_totalchargers, and ev_costperkwh. Charger network names and connector type breakdowns are not included in the current response. You can fork this API on Parse and revise it to add those fields if an appropriate source is available.