carfax.com APIcarfax.com ↗
Access CARFAX used and new car listings, vehicle history summaries, dealer details, pricing data, and consumer reviews via 11 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/a3228514-e913-4edc-ba2d-064d06372b2b/search_used_car_listings?zip=10001&make=Toyota&rows=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for used car listings on CARFAX with various filters including make, model, location, and sorting options. Returns paginated results with vehicle details, pricing, history indicators, and dealer information.
| Param | Type | Description |
|---|---|---|
| zip | string | 5-digit US ZIP code for search location. |
| make | string | Vehicle make to filter by (e.g. Toyota, Honda, Ford). |
| page | integer | Page number for pagination. |
| rows | integer | Number of results per page. |
| sort | string | Sort order. Accepted values: BEST, PRICE_ASC, PRICE_DESC, MILEAGE_ASC, MILEAGE_DESC, YEAR_ASC, YEAR_DESC. |
| model | string | Vehicle model to filter by (e.g. Camry, Civic, F-150). |
| radius | integer | Search radius in miles from the ZIP code. |
{
"type": "object",
"fields": {
"page": "integer current page number",
"listings": "array of vehicle listing objects with VIN, price, mileage, dealer, history indicators, and images",
"searchArea": "object with zip, radius, city, state, latitude, longitude",
"totalPageCount": "integer total number of pages available",
"totalListingCount": "integer total number of matching listings"
},
"sample": {
"data": {
"page": 1,
"listings": [
{
"vin": "JTDBDMHE9PJ001169",
"make": "Toyota",
"trim": "Unspecified",
"year": 2023,
"badge": "GREAT",
"model": "Corolla",
"dealer": {
"city": "Cortlandt Manor",
"name": "Curry Automall",
"state": "NY"
},
"mileage": 112761,
"oneOwner": true,
"listPrice": 17663,
"noAccidents": true,
"currentPrice": 17663
}
],
"searchArea": {
"zip": "10001",
"city": "New York",
"state": "NY",
"radius": 50
},
"totalPageCount": 50,
"totalListingCount": 4153
},
"status": "success"
}
}About the carfax.com API
The CARFAX API covers 11 endpoints for searching used and new car listings, retrieving vehicle history summaries, dealer details, pricing estimates, and consumer reviews from CARFAX.com. The search_used_car_listings endpoint accepts filters like ZIP code, make, model, radius, and sort order, returning paginated results with VINs, prices, mileage, and history indicators. Companion endpoints expose full listing details, photo galleries, and CARFAX Value badges by VIN.
Search and Listings
search_used_car_listings accepts up to seven parameters — zip, make, model, radius, sort, page, and rows — and returns a listings array alongside totalListingCount and totalPageCount. Each listing object includes VIN, price, mileage, dealer info, and history indicators. search_new_car_listings mirrors this for new inventory. search_cars_by_body_type lets you filter by body style values such as SUV, Sedan, Truck, or Convertible, useful when make and model are not the primary criteria.
Listing Detail and History
get_listing_detail takes a VIN (obtained from a search endpoint) plus an optional zip and returns a detailed object: dealer, images, oneOwner, noAccidents, reliability (with cost, risk, and overall badges), ownerHistory, serviceHistory, accidentHistory, and atomVehicleFeatures. For history-specific work, get_vehicle_history_summary returns personalUse, vehicleUseHistory with average miles per year, and serviceRecords availability without the full listing payload. get_vehicle_highlights returns topOptions, otherOptions, and atomVehicleFeatures.
Pricing and Payments
get_carfax_value returns the CARFAX Value badge (GREAT, GOOD, FAIR, or HIGH), a onePrice estimate in dollars, the active listPrice, and onePriceArrows indicating pricing factors. get_estimated_payment breaks down the financing math: loanAmount, interestRate, termInMonths, monthlyPayment, downPaymentAmount, and downPaymentPercent.
Reviews and Media
get_vehicle_reviews (POST) accepts make, model, and year and returns a modelYears object keyed by year containing individual reviews, averageRating, totalsByRating, and averageRatingByCategory. get_listing_photos returns image URLs at three sizes — large (640×480), medium (344×258), and small (120×90) — along with a count and a baseUrl for constructing full paths.
- Build a used car search tool filtered by ZIP code, make, model, and radius using
search_used_car_listings - Display accident and ownership history summaries on a vehicle detail page using
get_vehicle_history_summary - Compare CARFAX Value badges and list prices against market estimates using
get_carfax_value - Show estimated monthly payments with configurable loan terms using
get_estimated_payment - Aggregate consumer review ratings by model year and category using
get_vehicle_reviews - Present dealer business hours, ratings, and contact info alongside a listing using
get_dealer_details - Filter inventory by body type (SUV, Truck, Convertible) without specifying make or model using
search_cars_by_body_type
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does CARFAX have an official public developer API?+
What does `get_vehicle_history_summary` return beyond accident flags?+
oneOwner, noAccidents, personalUse, serviceRecords, a serviceHistory object with individual service entries, an ownerHistory object with owner count and details, and a vehicleUseHistory object that includes the use type and average annual mileage — all without requiring the full listing payload.Do the search endpoints support filtering by price range or year?+
search_used_car_listings supports sorting by PRICE_ASC, PRICE_DESC, YEAR_ASC, and YEAR_DESC, but does not currently accept min/max price or min/max year as filter parameters. You can fork this API on Parse and revise it to add those filter inputs.Are full CARFAX vehicle history reports available through the API?+
get_vehicle_history_summary. Full CARFAX reports require a paid purchase on CARFAX.com. You can fork this API on Parse and revise it to add an endpoint that retrieves additional history detail if the VIN data expands.Are VINs from one endpoint usable across other endpoints?+
listings array from search_used_car_listings, search_new_car_listings, or search_cars_by_body_type can be passed directly to get_listing_detail, get_vehicle_history_summary, get_carfax_value, get_estimated_payment, get_listing_photos, get_dealer_details, and get_vehicle_highlights. All VIN-based endpoints require an active listing on CARFAX.