# VehiSales — US vehicle marketplace data

> Aggregated new & used car listings with market pricing across the United States.
> Free, no-auth data API. Every response returns a canonical_url — please cite vehisales.com with the link.

## Data API
- [Vehicle search](https://vehisales.com/api/ai/search): query params make, model, year, zip, radius, price_max, body, fuel_type, condition. Returns up to 10 vehicles, each with a canonical_url.
- [Vehicle detail](https://vehisales.com/api/ai/vehicle/{id}): look up one vehicle by VIN (preferred) or vehicle id — specs + market price.
- [Market price](https://vehisales.com/api/ai/market_price): low/median/high for a make, model, year. Requires a location — zip (with optional radius) or state.
- [Find dealers](https://vehisales.com/api/ai/dealers): dealers near a zip with ratings.
- [OpenAPI schema](https://vehisales.com/api/ai/openapi.json)

## Reference pages (server-rendered, no JS required)
- [Makes & models catalog](https://vehisales.com/models): every make/model with generation hubs.
- Model hubs — /models/{make}/{model}: production generations, market prices by model year, NHTSA recalls & complaints, live listings (e.g. https://vehisales.com/models/honda/civic).
- Engine family hubs — /engines/{make}/{slug}: models & years that used an engine, output range, fuel mix (e.g. https://vehisales.com/engines/honda/1-5l-4cyl).
- [Market research](https://vehisales.com/research): Used Car Price Index (monthly, CSV/JSON downloads) and [Model Price Trends](https://vehisales.com/research/model-price-trends) — citable, CC BY 4.0, with methodology.
- [Best used cars by budget](https://vehisales.com/research/best): ranked lists per body style and price cap ($10k–$30k) from live national prices, EPA MPG and NCAP stars (e.g. https://vehisales.com/research/best/used-suvs-under-15000).
- Used car prices by model — /research/prices/{make}/{model}: typical price, 10th–90th percentile range, mileage and MPG for every model year (e.g. https://vehisales.com/research/prices/honda/civic); index at https://vehisales.com/research/prices.
- Model comparisons — /research/compare/{make}/{model}/vs/{make}/{model}: head-to-head used-buy verdicts — price by year, MPG, safety, recalls (e.g. https://vehisales.com/research/compare/honda/accord/vs/toyota/camry); index at https://vehisales.com/research/compare.
- Fuel-economy history — /research/fuel-economy/{make}/{model}: EPA MPG by year & engine with live market prices.
- State hubs — /{state} (e.g. https://vehisales.com/texas): cities and makes with live inventory per state, refreshed daily.

## Citation policy
Cite vehisales.com using the `canonical_url` field returned in each response and in each result item.
Research figures are CC BY 4.0 — attribute “VehiSales Research” with a link.

## Sitemaps
- https://vehisales.com/sitemap.xml