Fuel Prices Scraper

Pricing

Rating

Developer

Actor stats

Categories

Share

Daily US fuel prices from the AAA Fuel Gauge. National, state (50 + DC), and metro/county averages for regular, mid-grade, premium, and diesel — with current/yesterday/week/month/year-ago history. HTTP-only — no cookies, no proxy, no auth.

What this actor does

• Fetches the public AAA Fuel Gauge pages
• Parses national, state, and metro-level fuel prices
• Returns one record per scope (1 national / 51 state / hundreds of metro records)
• Includes price history (yesterday / week ago / month ago / year ago) and derived change metrics (in cents)
• Pro filters narrow output to specific states, fuel types, price bands, or metro substring matches

Modes

Output per record

State / metro records include:

• scope (national / state / metro)
• country (national only — always US)
• state, stateCode (state and metro records)
• metro (metro records only)
• regular, midGrade, premium, diesel (USD/gal — only fuels actually published)
• history (object — yesterday / weekAgo / monthAgo / yearAgo × fuel grade)
• changeFromYesterday, changeFromWeekAgo, changeFromMonthAgo, changeFromYearAgo (cents — computed from primaryFuelType, default regular)
• recordType: "fuelPrices", scrapedAt

Empty fields are omitted from the output (no nulls).

Input

Example: state averages

{
"mode":"state",
"states":[],
"includeHistory":true,
"includeChangeMetrics":true,
"sortBy":"price_asc"
}

Example: metros in NY + CA

{
"mode":"metro",
"states":["NY","CA"],
"metroNameFilter":["new york","los angeles","san francisco"]
}

Example: cheapest diesel by state

{
"mode":"state",
"primaryFuelType":"diesel",
"fuelTypes":["diesel"],
"sortBy":"price_asc",
"maxItems":10
}

Use cases

• Fleet planning — compare diesel prices across states for routing
• News + editorial — daily "where gas is cheapest" digest, broken out by state and metro
• Consumer apps — power a "national fuel price" widget with one daily run
• Trend tracking — monitor changeFromYearAgo to flag big YoY moves
• Inflation dashboards — fuel is a leading retail-inflation indicator

FAQ

Does it require a login or cookies? No. The AAA Fuel Gauge is fully public.

Is a proxy needed? No. Datacenter IPs work fine.

Does it cover countries other than the US? Not yet. AAA's Fuel Gauge is US-only.

Why aren't station-level (per-pump) prices included? Per-station data sources (e.g. GasBuddy) are heavily rate-limited and blocked from datacenter IPs. State + metro aggregates from AAA are the most reliable, free, datacenter-friendly source.

How fresh is the data? AAA updates daily (overnight). The actor reads the page directly so each run reflects the latest published averages.

Why do some states miss a fuel grade? Some states don't publish every grade. The omit-empty contract drops missing fields rather than emit nulls.

Why is changeFromMonthAgo sometimes missing? It's computed only when both current price and the relevant history bucket are present.

What does metroNameFilter match against? Case-insensitive substring of the metro/county name as published by AAA (e.g. Albany-Schenectady-Troy, Nassau-Suffolk).