Finance

Gas Prices

Get the latest or a historical week of average retail fuel prices for a country or US area.

get/v1/gasprices

Request

  • Base URL: https://api.apiverve.com
  • URL: https://api.apiverve.com/v1/gasprices
  • Auth: API key in header x-api-key

Query parameters

countrystring

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.

areastring

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.

currencystring

Currency to return prices in, as an ISO code (e.g. USD, EUR, GBP). Defaults to the country's own currency.

unitstring

Volume unit to price per: liter or gallon. Defaults to the source's unit (gallon for the US, liter elsewhere).

datestring

Date to look up (YYYY-MM-DD). Returns the survey week in effect on that date. Omit for the latest week.

Response

Successful Response

statusstring

status

errorstring

error

dataobject

data

Changes

No recorded changes to this operation across all 1 revision of this API.