Vehicle Fuel Economy in Google Sheets & Excel

What this pulls

Vehicle Fuel Economy returns the EPA ratings of every car and light truck sold in the US since 1984, electric vehicles included. Search by make, model, year and fuel type to get city, highway and combined MPG (or MPGe), electric range, engine, drive and transmission. Paid plans add kWh per 100 miles, charge time at 240V, annual fuel cost, five-year savings, CO2 per mile and the EPA fuel economy, greenhouse gas and smog scores.

It's one of 250+ live sources you reach with a single =VERVE() function — served from APIVerve's production data engine, billed at 1 credit per resolved cell, and refreshed on whatever cadence you set. No API keys to wrangle, no scripts, no exports.

See it in a cell

A real example — the input you type, and the values you can pull from it. Click any cell to see the formula behind it.

vehiclefueleconomy.xlsxsample data

A2fx=VERVE("vehiclefueleconomy", "count")

Count

Page

Pages

Returned

click any cell to see its formula1 credit / cell

Ways to use it

One value per row

Fill =VERVE("vehiclefueleconomy", "count") down a column and Vehicle Fuel Economy returns a result for every row — a batch of live values in a single drag, no code.

Enrich data in place

Add Vehicle Fuel Economy beside a table you already have to append its output right where your data lives, then sort, filter, or chart on it.

Live or frozen

Keep the vehicle fuel economy values as formulas that look up again when their inputs change, or fill them as plain values that never move.

Use it in your sheet

The same function works in both apps — install once, sign in with your key, and type it into any cell.

Google SheetsAdd-on

Install from the Workspace Marketplace, then drop the formula into a cell. Autocomplete suggests the source and its fields.

=VERVE("vehiclefueleconomy", "count")

Microsoft ExcelAdd-in

Same source, same arguments, same key — in Excel on desktop, the web, or mobile. Excel namespaces it as VERVE.CALL. Drag to fill a whole column.

=VERVE.CALL("vehiclefueleconomy", "count")

Optional inputs

Tune the result by adding name=value before the field argument — in any order. Leave one out and its default applies.

make
Vehicle make, for example Toyota, Ford or Tesla. Either make or model is required
=VERVE("vehiclefueleconomy", "count", "make", "Tesla")
model
Model name or the start of it, for example Camry or Model 3. Either make or model is required
=VERVE("vehiclefueleconomy", "count", "model", "Model 3")
year
Model year, 1984 or later
=VERVE("vehiclefueleconomy", "count", "year", "2024")
fuelType
Only vehicles with this powertrain
=VERVE("vehiclefueleconomy", "count", "fuelType", "electric")
limit
Vehicles per page, 1-50
=VERVE("vehiclefueleconomy", "count", "limit", "20")
page
Page of results to return, starting at 1
=VERVE("vehiclefueleconomy", "count", "page", "1")

Fields you can pull

Add a field name right after the inputs to land just that value in the cell.

Count
=VERVE("vehiclefueleconomy", "count")
Pages
=VERVE("vehiclefueleconomy", "pages")
Returned
=VERVE("vehiclefueleconomy", "returned")
Vehicles
=VERVE("vehiclefueleconomy", "vehicles")
Vehicles › Epa Id
=VERVE("vehiclefueleconomy", "vehicles.0.epaId")
Vehicles › Year
=VERVE("vehiclefueleconomy", "vehicles.0.year")
Vehicles › Make
=VERVE("vehiclefueleconomy", "vehicles.0.make")
Vehicles › Model
=VERVE("vehiclefueleconomy", "vehicles.0.model")
Vehicles › Base Model
=VERVE("vehiclefueleconomy", "vehicles.0.baseModel")
Vehicles › Vehicle Class
=VERVE("vehiclefueleconomy", "vehicles.0.vehicleClass")
Vehicles › Powertrain
=VERVE("vehiclefueleconomy", "vehicles.0.powertrain")
Vehicles › Fuel Type
=VERVE("vehiclefueleconomy", "vehicles.0.fuelType")

Vehicle Fuel Economy, answered

Everything you need to wire it into a sheet.

How do I pull Vehicle Fuel Economy into Google Sheets?

Install the VerveSheets add-on, sign in once with your key, and type =VERVE("vehiclefueleconomy", "count") into any cell. The argument after the inputs names the value you want back, so the cell resolves to a single number or string you can chart, sort, or feed into another formula.

What data can I pull from Vehicle Fuel Economy?

Vehicle Fuel Economy returns count, pages, returned, vehicles and vehicles.0.epaId, plus 7 more — name any one of them after the inputs and that value lands in the cell. Leave the field out and the whole record spills into a two-column table instead.

Can I narrow what Vehicle Fuel Economy returns?

Yes — Vehicle Fuel Economy takes "make", "model", "year" and "fuelType", plus 2 more as optional inputs. They go in as "name", value pairs after the inputs and the field, in any order, so =VERVE("vehiclefueleconomy", "count", "make", "Tesla") shapes the result without changing anything else.

Can I fill a whole column of Vehicle Fuel Economy at once?

Yes. Reference a range instead of a single cell and one call returns a value for every row, or drag =VERVE("vehiclefueleconomy") down like any spreadsheet function.

How many credits does each Vehicle Fuel Economy cell cost?

Each resolved cell costs 1 credit. A cell only re-bills when it actually refreshes, so a sheet you aren't touching doesn't keep charging.

Does Vehicle Fuel Economy work in Excel as well as Google Sheets?

Yes — same arguments, same key, same fields. Excel namespaces custom functions, so the call is =VERVE.CALL() there and =VERVE() in Google Sheets; nothing else about it changes.

How current is Vehicle Fuel Economy?

It draws on 50k vehicles since 1984, served live from APIVerve's production data engine, and a cell looks up again whenever its inputs change.

Vehicle Fuel Economy

One value per row

Enrich data in place

Live or frozen

Vehicle Fuel Economy, answered

Put Vehicle Fuel Economy in your next spreadsheet. Add the extension, paste the formula, and the cell keeps itself current.

Scaling up?