Gas Prices API

GET

Price fuel costs off official weekly pump price surveys in 29 countries.

Gas Prices returns average retail gasoline, diesel and LPG prices from official weekly government surveys for the US, the UK, all 27 EU countries and the EU average. Pass a country, or a US state, region or city, to get the latest week with week-over-week and year-over-year changes, in any currency, per liter or per gallon.

Try it — live request, no key required

Request

GETapi.apiverve.com/v1/gasprices

Verification

Format

No key required to try it. Get a key to use it in your app.

Example

{
  "status": "ok",
  "error": null,
  "data": {
    "country": "US",
    "countryName": "United States",
    "area": "US",
    "areaName": "United States",
    "areaType": "national",
    "week": "2026-09-28",
    "currency": "USD",
    "unit": "gallon",
    "prices": {
      "regular": 4.465,
      "midgrade": 5.073,
      "premium": 5.482,
      "diesel": 6.382,
      "allGrades": 4.603,
      "lpg": null
    },
    "changeDirection": "down",
    "previousWeek": "2026-09-21",
    "weeklyChange": {
      "regular": -0.013,
      "midgrade": 0.012,
      "premium": 0.022,
      "diesel": -0.147,
      "allGrades": -0.007,
      "lpg": null
    },
    "yearAgoWeek": "2025-09-29",
    "yearlyChange": {
      "regular": 1.347,
      "midgrade": 1.366,
      "premium": 1.415,
      "diesel": 2.628,
      "allGrades": 1.355,
      "lpg": null
    },
    "nativeCurrency": "USD",
    "nativeUnit": "gallon",
    "exchangeRate": 1
  }
}

About the Gas Prices API

Gas Prices is built on three official weekly surveys: the U.S. Energy Information Administration retail gasoline and diesel survey (since 1990, including nine states and ten metro areas), the European Commission Weekly Oil Bulletin for every EU member (since 2005) and the UK government weekly road fuel prices (since 2003). Each price is stored as published, in the currency drivers pay, and can be converted to any currency and to liters or gallons on request. Use it for fuel cost calculators, fleet budgeting, delivery surcharges and cross-country cost comparisons.

What people use it for

Trip Fuel Cost Calculators: Estimate the fuel cost of a road trip by multiplying route distance and vehicle efficiency by the current price for the country, state or city being driven through.
Fleet Fuel Budgeting: Logistics teams forecast monthly fuel spend by tracking weekly diesel prices and the year-over-year change in every country their trucks operate in.
Delivery Fuel Surcharges: Couriers and freight brokers tie fuel surcharges to the weekly national diesel average so pricing adjusts automatically as pump prices move.
Cross-Country Cost Comparisons: Travel and relocation sites compare what drivers pay across Europe and the US by requesting every country in one currency and per liter.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON: Default REST response
XML: Markup format
YAML: Human-readable
CSV: Tabular export
GraphQL: Query language
MCP: For AI agents

View all integrations →

Other ways to use Gas Prices

Same data, same APIVerve account, same credit balance — one key works on all of them.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.on VerveKit Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.on VerveSheets Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.on VerveContext

Questions.

Common questions about the Gas Prices API.

Read the docs →

Which countries, areas and fuel grades are covered?

The API covers the US, the UK, all 27 EU countries and the EU average. In the US you can also pick one of nine states (CA, CO, FL, MA, MN, NY, OH, TX, WA), a PADD region or ten cities. US prices include regular, midgrade, premium, all-grades gasoline and diesel; EU prices include euro-super 95 (as regular), diesel and LPG; UK prices include unleaded (as regular) and diesel. Station-level and ZIP code prices are not included.

Where do the prices come from and how fresh are they?

Prices come from official weekly government surveys: the U.S. Energy Information Administration, the European Commission Weekly Oil Bulletin and the UK Department for Energy Security and Net Zero. All three report Monday prices, and the API refreshes twice a day so each new week appears soon after it is published.

What does the Free plan include?

The Free plan returns the current US national average price of regular gasoline, per gallon or per liter, and the direction of the latest weekly move. Every other country, US states, regions and cities, the midgrade, premium, diesel and LPG prices, currency conversion, past weeks and the week-over-week and year-over-year changes all require a paid plan.

Which plan fits 25,000 gas price lookups a month?

Starter handles this volume with room to spare. At 2 credits per call, 25,000 lookups use 50,000 credits, or one-quarter of the 200,000 credits on Starter. That works out to about $0.30 per 1,000 calls. The Free plan includes 100 calls per month.

Which exchange rate is used when I ask for another currency?

Conversions use the latest exchange rate, refreshed hourly, including for historical weeks. The response returns the rate it applied in exchangeRate and the original currency in nativeCurrency. Non-euro EU countries such as Poland and Sweden are published in their own currency, converted at the European Commission weekly rate for that week.

Request parameters — GET /v1/gasprices

Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them. Anything not listed here is dropped rather than passed through.

Optional

Parameter	Type	Example	Description
`country`Optional	string	`US`	Country to get prices for: US, GB, EU (the EU average) or any EU member code such as DE, FR or PL. Defaults to US. Countries other than US require a paid plan. `USGBEUATBEBGCYCZ`+22
`area`Optional	string	`CA`	US only: a state code (CA, CO, FL, MA, MN, NY, OH, TX, WA), a region (eastcoast, midwest, gulfcoast, rockymountain, westcoast and the PADD 1 sub-regions) or a city (losangeles, chicago, houston, newyorkcity and more). Omit for the national average. Requires a paid plan. `USeastcoastnewenglandcentralatlanticloweratlanticmidwestgulfcoastrockymountain`+21
`currency`OptionalPremium	string	`USD`	Currency to return prices in, as an ISO code (e.g. USD, EUR, GBP). Defaults to the country's own currency. length 3-3
`unit`Optional	string	`liter`	Volume unit to price per: liter or gallon. Defaults to the source's unit (gallon for the US, liter elsewhere). `litergallon`
`date`OptionalPremium	string	`2024-06-15`	Date to look up (YYYY-MM-DD). Returns the survey week in effect on that date. Omit for the latest week. date

Example request

1
2

curl "https://api.apiverve.com/v1/gasprices?country=US&area=CA&currency=USD&unit=liter&date=2024-06-15" \
  -H "x-api-key: YOUR_API_KEY"

Authentication

Send your key in the x-api-key header. That is the only auth step — no token exchange, and no per-endpoint scope to configure.

Header	When	Value
`x-api-key`Required	Every request	Your API key. Header names are case-insensitive, so `X-API-Key` is the same header.
`Authorization`Alternate	Instead of the above	`Bearer <key>` — for clients that only expose bearer auth. Resolves to the same account and the same billing.

401 is the only auth verdict

A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.

Response — GET /v1/gasprices

Every APIVerve endpoint returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape.

Sample response

{
  "status": "ok",
  "error": null,
  "data": {
    "country": "US",
    "countryName": "United States",
    "area": "US",
    "areaName": "United States",
    "areaType": "national",
    "week": "2026-09-28",
    "currency": "USD",
    "unit": "gallon",
    "prices": {
      "regular": 4.465,
      "midgrade": 5.073,
      "premium": 5.482,
      "diesel": 6.382,
      "allGrades": 4.603,
      "lpg": null
    },
    "changeDirection": "down",
    "previousWeek": "2026-09-21",
    "weeklyChange": {
      "regular": -0.013,
      "midgrade": 0.012,
      "premium": 0.022,
      "diesel": -0.147,
      "allGrades": -0.007,
      "lpg": null
    },
    "yearAgoWeek": "2025-09-29",
    "yearlyChange": {
      "regular": 1.347,
      "midgrade": 1.366,
      "premium": 1.415,
      "diesel": 2.628,
      "allGrades": 1.355,
      "lpg": null
    },
    "nativeCurrency": "USD",
    "nativeUnit": "gallon",
    "exchangeRate": 1
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Field	Type	Example	Description
`country`	string	`"US"`	ISO country code the prices apply to (EU for the European Union average)
`countryName`	string	`"United States"`	Country name
`area`	string	`"US"`	Area code the prices apply to: the country code for national prices, or a US state code, region or city key
`areaName`	string	`"United States"`	Human-readable area name
`areaType`	string	`"national"`	Area granularity: national, union, region, state or city
`week`	string	`"2026-09-28"`	Survey week (Monday) in YYYY-MM-DD format
`currency`	string	`"USD"`	ISO currency code of all prices and changes in this response
`unit`	string	`"gallon"`	Volume unit prices are quoted per: gallon or liter
`prices`	object	`{...}`	Average retail price per unit by fuel grade
`regular`	number	`4.465`	Average retail price of regular unleaded per unit; null where the source does not survey it for this area
`midgrade`Premium	number	`5.073`	Average retail price of midgrade per unit; null where the source does not survey it for this area
`premium`Premium	number	`5.482`	Average retail price of premium per unit; null where the source does not survey it for this area
`diesel`Premium	number	`6.382`	Average retail price of No. 2 diesel per unit; null where the source does not survey it for this area
`allGrades`Premium	number	`4.603`	Average retail price of all gasoline grades combined per unit; null where the source does not survey it for this area
`lpg`Premium	object	`null`	Average retail price of LPG (autogas) per unit; null where the source does not survey it for this area
`changeDirection`	string	`"down"`	Direction of the weekly change in regular gasoline: up, down or unchanged
`previousWeek`Premium	string	`"2026-09-21"`	Date of the prior survey week used for the weekly change
`weeklyChange`	object	`{...}`	Change in price per unit from the previous survey week, by grade
`regular`Premium	number	`-0.013`	Week-over-week change in the regular unleaded price, in currency per unit
`midgrade`Premium	number	`0.012`	Week-over-week change in the midgrade price, in currency per unit
`premium`Premium	number	`0.022`	Week-over-week change in the premium price, in currency per unit
`diesel`Premium	number	`-0.147`	Week-over-week change in the No. 2 diesel price, in currency per unit
`allGrades`Premium	number	`-0.007`	Week-over-week change in the all gasoline grades combined price, in currency per unit
`lpg`Premium	object	`null`	Week-over-week change in the LPG (autogas) price, in currency per unit
`yearAgoWeek`Premium	string	`"2025-09-29"`	Date of the survey week one year earlier used for the yearly change
`yearlyChange`	object	`{...}`	Change in price per unit from the same week a year earlier, by grade
`regular`Premium	number	`1.347`	Year-over-year change in the regular unleaded price, in currency per unit
`midgrade`Premium	number	`1.366`	Year-over-year change in the midgrade price, in currency per unit
`premium`Premium	number	`1.415`	Year-over-year change in the premium price, in currency per unit
`diesel`Premium	number	`2.628`	Year-over-year change in the No. 2 diesel price, in currency per unit
`allGrades`Premium	number	`1.355`	Year-over-year change in the all gasoline grades combined price, in currency per unit
`lpg`Premium	object	`null`	Year-over-year change in the LPG (autogas) price, in currency per unit
`nativeCurrency`	string	`"USD"`	Currency the source publishes in (USD for the US, GBP for the UK, EUR or the local currency in the EU)
`nativeUnit`	string	`"gallon"`	Unit the source publishes in (gallon for the US, liter elsewhere)
`exchangeRate`	number	`1`	Rate applied to convert from nativeCurrency to currency; 1 when no conversion was requested

Response headers

Every response carries your balance, so your own code always knows where it stands without polling anything. All four are exposed to browsers through CORS.

Header	What it carries
`x-api-remaining-credits`	Credits left in the current cycle
`x-api-credits-used`	Credits spent in the current cycle
`x-api-max-credits`	The allowance for the cycle
`x-api-version`	Version of the endpoint that answered

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change.

Status	Meaning	What to do
`400`	Input was rejected	Read `error`; it names the parameter that has to change.
`401`	Key missing or invalid	Check the header name and the key value.
`403`	Key valid, but not permitted here	A key restriction or an IP allow-list — never a bad key.
`429`	Rate limited, or out of credits	Read `error` to tell them apart, then back off or top up.

What a call costs — 2 credits per call

Credits are shared across every APIVerve API — one balance, one key, one bill. Failed requests never count against it, so a rejected input costs nothing.

Plan	Per month	Credits	Gas Prices calls	Per 1,000 calls
Free	Free	200	100	Free
Starter	$29.99	200,000	100,000	$0.30
Pro	$99.99	1,000,000	500,000	$0.20
Mega	$299.99	4,000,000	2,000,000	$0.15

Calls are what the credits buy at this API's rate — spend them here, on any of the other APIs, or across both. Nothing is reserved per endpoint.

Compare all pricing tiers →

Call it from cURL — GET /v1/gasprices

No SDK to install — this is a plain HTTPS call to /v1/gasprices with your key in the x-api-key header. Swap in a real key and it runs as-is.

cURL

1
2

curl "https://api.apiverve.com/v1/gasprices" \
  -H "x-api-key: YOUR_API_KEY"

Resources

ReferenceGas Prices API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Node.js — GET /v1/gasprices

No SDK to install — this is a plain HTTPS call to /v1/gasprices with your key in the x-api-key header. Swap in a real key and it runs as-is.

Node.js

const res = await fetch("https://api.apiverve.com/v1/gasprices", {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const { data } = await res.json();
console.log(data);

Resources

ReferenceGas Prices API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Python — GET /v1/gasprices

No SDK to install — this is a plain HTTPS call to /v1/gasprices with your key in the x-api-key header. Swap in a real key and it runs as-is.

Python

import requests

res = requests.get(
    "https://api.apiverve.com/v1/gasprices",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(res.json()["data"])

Resources

ReferenceGas Prices API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from C# / .NET — GET /v1/gasprices

No SDK to install — this is a plain HTTPS call to /v1/gasprices with your key in the x-api-key header. Swap in a real key and it runs as-is.

C# / .NET

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var json = await client.GetStringAsync("https://api.apiverve.com/v1/gasprices");
Console.WriteLine(json);

Resources

ReferenceGas Prices API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Go — GET /v1/gasprices

No SDK to install — this is a plain HTTPS call to /v1/gasprices with your key in the x-api-key header. Swap in a real key and it runs as-is.

req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/gasprices", nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))

Resources

ReferenceGas Prices API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from PHP — GET /v1/gasprices

No SDK to install — this is a plain HTTPS call to /v1/gasprices with your key in the x-api-key header. Swap in a real key and it runs as-is.

PHP

$ch = curl_init("https://api.apiverve.com/v1/gasprices");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);

$response = curl_exec($ch);
echo $response;

Resources

ReferenceGas Prices API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Ruby — GET /v1/gasprices

No SDK to install — this is a plain HTTPS call to /v1/gasprices with your key in the x-api-key header. Swap in a real key and it runs as-is.

Ruby

require "net/http"

uri = URI("https://api.apiverve.com/v1/gasprices")
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = "YOUR_API_KEY"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

Resources

ReferenceGas Prices API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Finance

View all 50 →

Gas Prices API

Try it — live request, no key required

About the Gas Prices API

What people use it for

Ways to call it

Other ways to use Gas Prices

Questions.

Request parameters — GET /v1/gasprices

Optional

Authentication

Response — GET /v1/gasprices

Response fields

Response headers

Errors

What a call costs — 2 credits per call

Call it from cURL — GET /v1/gasprices

Resources

Call it from Node.js — GET /v1/gasprices

Resources

Call it from Python — GET /v1/gasprices

Resources

Call it from C# / .NET — GET /v1/gasprices

Resources

Call it from Go — GET /v1/gasprices

Resources

Call it from PHP — GET /v1/gasprices

Resources

Call it from Ruby — GET /v1/gasprices

Resources

Zero-code embed — one snippet, no backend

Changelog — Gas Prices API

Finance

Ready to build with Gas Prices? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog