US Gas Price Tracker by State & Metro
Daily US fuel prices for regular, mid-grade, premium, and diesel at the national, state, and metro level, with yesterday/week/month/year-ago history and derived price changes.
Open in Apify Store$0.99 / 1K on Free
Short answer
US Gas Price Tracker by State & Metro is an Apify Store Actor that returns 8 published output fields, including scope, state, metro, regular. It lists $0.99 per 1,000 results on the Free plan (pay per event), $0.49 on the Business plan. It takes 11 input settings; one is required (mode). Last updated Nov 19, 2026.
From the public Store listing and published build schema, synced 2026-11-19.What it returns
8 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.
scopestatemetroregularmidGradepremiumdieselscrapedAt
Input
| Setting | Type | Required | Default | What it does |
|---|---|---|---|---|
| mode | string | Yes | state | What to scrape. `national` = single record (US average). `state` = 51 records (50 states + DC) with current/yesterday/week/month/year-ago prices. `metro` = metro/county-level prices for the requested states. |
| states | array | No | [] | Two-letter state codes (e.g. `NY`, `CA`, `TX`). Empty = all 50 states + DC. For `mode=metro`, this controls which state pages get scraped. |
| fuelTypes | array | No | ["regular","midGrade","premium","diesel"] | Which fuel grades to include in each record. Empty = all four (regular, midGrade, premium, diesel). |
| includeHistory | boolean | No | true | When true (state/metro modes), include yesterday/week-ago/month-ago/year-ago averages. Default true. |
| minPrice | number | No | – | Drop records whose primary fuel (regular by default) is below this price. |
| maxPrice | number | No | – | Drop records whose primary fuel (regular by default) is above this price. |
| primaryFuelType | string | No | regular | Which fuel grade is used by `minPrice` / `maxPrice` / `sortBy` filters. Default: regular. |
| sortBy | string | No | state_asc | How to order emitted records. Cheapest-first / most-expensive-first / alphabetical by state. |
| includeChangeMetrics | boolean | No | true | When true and history is fetched, also emit `changeFromYesterday`, `changeFromWeekAgo`, `changeFromMonthAgo`, `changeFromYearAgo` (in cents). |
| metroNameFilter | array | No | [] | Only emit metro records whose name contains one of these substrings (case-insensitive). e.g. ['New York','Los Angeles']. |
Show the other 1 settings
| Setting | Type | Required | Default | What it does |
|---|---|---|---|---|
| maxItems | integer | No | 500 | Hard cap on emitted records. |
Example input
Built from the input form's published example values and defaults.
{
"mode": "state",
"states": [],
"fuelTypes": [
"regular",
"midGrade",
"premium",
"diesel"
],
"includeHistory": true,
"primaryFuelType": "regular",
"sortBy": "state_asc",
"includeChangeMetrics": true,
"metroNameFilter": [],
"maxItems": 500
} Run it from code or an AI agent
The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.
Python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
"mode": "state",
"states": [],
"fuelTypes": [
"regular",
"midGrade",
"premium",
"diesel"
],
"includeHistory": True,
"primaryFuelType": "regular",
"sortBy": "state_asc",
"includeChangeMetrics": True,
"metroNameFilter": [],
"maxItems": 500
}
run = client.actor("dataspryva/us-gas-price-tracker-by-state-and-metro").call(run_input=run_input)
if run is None:
raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item) pip install apify-client
JavaScript
import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
"mode": "state",
"states": [],
"fuelTypes": [
"regular",
"midGrade",
"premium",
"diesel"
],
"includeHistory": true,
"primaryFuelType": "regular",
"sortBy": "state_asc",
"includeChangeMetrics": true,
"metroNameFilter": [],
"maxItems": 500
};
const run = await client.actor("dataspryva/us-gas-price-tracker-by-state-and-metro").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items); npm install apify-client
cURL
curl -X POST "https://api.apify.com/v2/actors/dataspryva~us-gas-price-tracker-by-state-and-metro/run-sync-get-dataset-items" -H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" -d '{"mode":"state","states":[],"fuelTypes":["regular","midGrade","premium","diesel"],"includeHistory":true,"primaryFuelType":"regular","sortBy":"state_asc","includeChangeMetrics":true,"metroNameFilter":[],"maxItems":500}' Waits for the run and returns the dataset items (runs over 300 seconds return HTTP 408; start an async run instead).
MCP (AI agents)
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com?tools=dataspryva/us-gas-price-tracker-by-state-and-metro",
"headers": {
"Authorization": "Bearer <YOUR_APIFY_TOKEN>"
}
}
}
} Adds this Actor as a tool in an MCP client that takes a remote server URL (Cursor, VS Code, Claude Code) through Apify's hosted MCP server. OAuth sign-in also works without the header. Clients that only start local servers can wrap the URL with npx mcp-remote.
What a run costs
The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.
| Apify plan | Per 1,000 | 10,000 results | 100,000 results |
|---|---|---|---|
| Free plan | $0.99 | $9.90 | $99 |
| Starter plan | $0.82 | $8.20 | $82 |
| Scale plan | $0.66 | $6.60 | $66 |
| Business plan | $0.49 | $4.90 | $49 |
- Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
- The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
- Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
- Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.
What people use it for
- Track fuel prices
- Compare regional price changes
Similar Actors
Google Books & Play Books Catalog Explorer
Search Google Books and Play Books by keyword, author, subject, ISBN or volume ID, and pull Ngram time series. Returns bibliographic metadata,…
SeatGeek Event Price Range & Listing Count Finder
Search SeatGeek by artist, team, or venue name, or browse 156 sports/concert/theater categories, and get each event's date, venue, price range,…
Hostelworld Property Ratings & Price Finder
Search Hostelworld hostels by city and dates, fetch specific property pages, or list top hostel cities, with ratings breakdown, prices, amenities,…
Kayak Flight, Hotel & Cheap Destination Finder
Searches Kayak for flight prices between two cities, cheap destinations from an origin airport, or hotel rates for a stay, with airline, price,…
OLX.pl Used Car Listings by Make & Fuel Type
Search olx.pl for used cars in Poland by keyword, fuel type, gearbox, condition, year, and price range. Get make, model, year, price in PLN,…
Subito.it Classifieds Search & Price Extractor
Search Subito.it classifieds for cars, electronics, or general items by keyword, Italian region, and price range, and get price, location, seller,…
Questions people ask
How much does US Gas Price Tracker by State & Metro cost?
The published result rate depends on your Apify plan: $0.99 per 1,000 on Free, $0.82 per 1,000 on Starter, $0.66 per 1,000 on Scale, $0.49 per 1,000 on Business. So 10,000 results cost about $9.90 on the Free plan and $4.90 on Business, plus a start fee of $0.10 per run per GB of memory on Free. Platform usage is billed separately.
What data does US Gas Price Tracker by State & Metro return?
Its published output schema lists 8 fields: scope, state, metro, regular, midGrade, premium, diesel, scrapedAt. A listed field is not guaranteed to be filled in every row.
What input does US Gas Price Tracker by State & Metro need?
Required: mode. Optional settings include states, fuelTypes, includeHistory, minPrice, maxPrice, primaryFuelType.
How do I run US Gas Price Tracker by State & Metro from Python or the API?
Use the Apify API client: in Python, ApifyClient(token).actor("dataspryva/us-gas-price-tracker-by-state-and-metro").call(run_input=...), then read the run's default dataset (run.default_dataset_id); in JavaScript the same call is client.actor("dataspryva/us-gas-price-tracker-by-state-and-metro").call(input). Without a client, POST the input JSON to https://api.apify.com/v2/actors/dataspryva~us-gas-price-tracker-by-state-and-metro/run-sync-get-dataset-items with your API token. Ready-to-paste code with the example input is on this page.
Sources
- US Gas Price Tracker by State & Metro on Apify Store
- Published build with input and output schema (JSON)
Cite this page
Scraper Finder. "US Gas Price Tracker by State & Metro." https://scraperfinder.com/catalogue/us-gas-price-tracker-by-state-and-metro/ (data checked 2026-11-19).
Run US Gas Price Tracker by State & Metro
$0.99 per 1,000 results. Paste the example input above, set your target query, then export the dataset.