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

What it returns

8 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

  • scope
  • state
  • metro
  • regular
  • midGrade
  • premium
  • diesel
  • scrapedAt

Input

Input settings for US Gas Price Tracker by State & Metro
SettingTypeRequiredDefaultWhat 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
More input settings for US Gas Price Tracker by State & Metro
SettingTypeRequiredDefaultWhat 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.

Cost of US Gas Price Tracker by State & Metro results by Apify plan
Apify planPer 1,00010,000 results100,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

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,…

17 output fields $0.99 per 1K

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,…

8 output fields $0.99 per 1K

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,…

11 output fields $0.99 per 1K

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,…

19 output fields $0.99 per 1K

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,…

13 output fields $0.99 per 1K

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,…

8 output fields $0.99 per 1K

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

Actor updated 2026-11-19 Data synced 2026-11-19
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.

Open in Apify Store