Search EV listings
search_listingsSearch every electric and plug-in hybrid vehicle listed for sale in the United States that Census tracks — new, used and certified, from dealers' own sites and manufacturer inventory. Returns matching listings with price, mileage, location, the seller's name and website, a seller link that forwards through censusev.com to the dealer's own page for the car, and the EV facts the site stands behind (battery kWh, EPA range, charge port, heat pump, DC fast charging), each marked estimated when it is not the manufacturer's own figure. Also returns a breakdown of every matching car, not only the returned page: cars per model year, cars per trim (top 8, when every match is one model), and the lowest, median and highest asking price. Each record carries last_seen, the day the car was last seen for sale. asking_vs_similar ("below", "typical" or "above") compares the asking price with similar cars on Census EV: the same version and model year within 40,000 miles, adjusted for mileage, counting cars listed now and cars no longer listed in the last 30 days at their last asking price. It compares asking prices and is not an appraisal. "below" and "above" need a gap of at least $1,000 that is also wider than the usual spread of asking prices for that version: for most cars about 3 to 7% over for "above" and about 5 to 9% under for "below", more where few similar cars are known, and "below" must still hold with any one similar car left out. Otherwise it is "typical". Absent when the car could not be compared: new or under 2,000 miles, no asking price or mileage, a disclosed buyback or branded title, fewer than 3 similar cars, similar cars that are not all one version, or an asking price so far under them that the gap is more than 30% of it. Inventory is as of the as_of timestamp in the result.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_listings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zip | No | 5-digit US ZIP; results are limited to radius_mi of it and sorted by distance unless sort is given. | |
| body | No | Comma-separated: "suv", "sedan", "truck", "van", "hatchback". | |
| kind | No | Battery-electric or plug-in hybrid. A car whose kind is not established matches neither; the result counts those in not_established.kind. | |
| make | No | Make, e.g. "Tesla", "Hyundai". | |
| sort | No | Result order. distance needs a zip. Default: distance when a zip is given, otherwise price_asc. | |
| drive | No | Comma-separated: "AWD", "RWD", "FWD". | |
| limit | No | Results to return, 1 to 100. Default 25. | |
| model | No | Model, e.g. "Model Y", "Ioniq 5". Punctuation and spacing are ignored. | |
| state | No | Comma-separated two-letter state codes, e.g. "CA,OR". | |
| detail | No | How much of each record to return. Default "compact", which leaves out id (the VIN in lower case), image_url, location.zip, location.lat, location.lng, previous_price_usd, price_changed_at, listed_on and first_seen. "full" returns every field. | |
| offset | No | Results to skip, for paging. Default 0. | |
| kwh_min | No | Minimum battery capacity in kWh. | |
| year_max | No | Latest model year to include. | |
| year_min | No | Earliest model year to include, e.g. 2022. | |
| condition | No | Comma-separated: "new", "used", "certified". | |
| heat_pump | No | Only cars known to have (yes) or not have (no) a heat pump. Cars where it is not established match neither, and are counted in not_established.heat_pump. | |
| price_max | No | Maximum asking price in USD. Cars with no real asking price are excluded when a price bound is given. | |
| price_min | No | Minimum asking price in USD. | |
| radius_mi | No | Search radius around zip, in miles. Default 100. | |
| range_min | No | Minimum EPA range in miles (electric-only for a plug-in hybrid). | |
| charge_port | No | Comma-separated: "NACS", "CCS1", "CHAdeMO". | |
| mileage_max | No | Maximum odometer reading in miles. Cars with no stated mileage are excluded when this is given. |