Search Used Cars By Body Type
omnial/search-cars-by-body-type
Given a vehicle body type (SUV, Sedan, Truck, Pickup, Minivan, Coupe, Convertible, Wagon, or Hatchback) and an optional ZIP code, returns matching used-car listings sourced from dealer inventory: year, make, model, trim, price, mileage, mechanical specs, notable features, a one-owner/no-accidents/service-history summary, a standard-assumptions monthly payment estimate, and the selling dealer's name, city, state, and rating -- for each listing.
activeper callv2
Price
Up to $0.0137 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/search-cars-by-body-type" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/search-cars-by-body-type" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/search-cars-by-body-type", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/search-cars-by-body-type", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0137 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"body_type"
],
"properties": {
"zip": {
"type": "string",
"description": "5-digit US ZIP code for search location."
},
"body_type": {
"type": "string",
"description": "Vehicle body type filter. Accepted values: SUV, Sedan, Truck, Pickup, Minivan, Coupe, Convertible, Wagon, Hatchback."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "An opaque identifier for this specific listing."
},
"vin": {
"type": "string"
},
"fees": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fee": {
"type": "number",
"description": "USD amount."
},
"feeType": {
"type": "string"
}
},
"additionalProperties": true
}
},
"fuel": {
"type": "string"
},
"make": {
"type": "string"
},
"trim": {
"type": "string"
},
"year": {
"type": "number"
},
"badge": {
"type": "string",
"description": "A short deal-quality label, e.g. 'GREAT'."
},
"model": {
"type": "string"
},
"dealer": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"name": {
"type": "string",
"description": "The dealership's business name."
},
"state": {
"type": "string"
},
"feeBadge": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'Price includes fees'."
},
"isValid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"dealerReviewDate": {
"type": "string"
},
"dealerReviewCount": {
"type": "number"
},
"dealerReviewRating": {
"type": "number"
},
"dealerAverageRating": {
"type": "number"
},
"dealerReviewComments": {
"type": "string",
"description": "The most recent public customer review's text."
},
"dealerReviewReviewer": {
"type": "string",
"description": "Anonymized on every real call observed, e.g. '2018 VOLKSWAGEN TIGUAN S Owner' -- not a real name."
},
"dealerBadgingExperience": {
"type": "string",
"description": "e.g. 'TOPRATED'."
}
},
"description": "The selling dealer's public business identity. Street address, phone number, and precise coordinates are intentionally not included.",
"additionalProperties": true
},
"engine": {
"type": "string"
},
"cabType": {
"type": "string",
"description": "Truck cab style, e.g. 'Crew Cab' -- 'Unspecified' on a non-truck."
},
"cpoData": {
"type": "object",
"properties": {
"cpo_body": {
"type": "string"
},
"make_name": {
"type": "string",
"description": "The manufacturer's CPO program brand, e.g. 'Volkswagen'."
},
"cpo_header": {
"type": "string"
},
"cpo_bullet_1": {
"type": "string"
},
"cpo_bullet_2": {
"type": "string"
},
"cpo_bullet_3": {
"type": "string"
}
},
"description": "Present only on certified pre-owned listings.",
"additionalProperties": true
},
"mileage": {
"type": "number"
},
"mpgCity": {
"type": "number",
"description": "Not present on every listing observed -- some carry mpgCombined instead."
},
"subTrim": {
"type": "string"
},
"bodytype": {
"type": "string"
},
"oneOwner": {
"type": "boolean"
},
"onePrice": {
"type": "number",
"description": "A total walk-in price figure, USD, generally higher than listPrice."
},
"bedLength": {
"type": "string",
"description": "Truck bed length, e.g. 'Short Bed' -- 'Unspecified' on a non-truck."
},
"certified": {
"type": "boolean",
"description": "Whether this is a certified pre-owned vehicle."
},
"drivetype": {
"type": "string"
},
"firstSeen": {
"type": "string",
"description": "Date this listing first appeared."
},
"listPrice": {
"type": "number",
"description": "The dealer's listed asking price, USD."
},
"allInPrice": {
"type": "boolean",
"description": "Whether the quoted price already includes dealer fees."
},
"dealerType": {
"type": "string",
"description": "e.g. 'NEW' for a new-car franchise dealer."
},
"imageCount": {
"type": "number",
"description": "Number of photos available for this listing."
},
"mpgHighway": {
"type": "number",
"description": "Not present on every listing observed -- some carry mpgCombined instead."
},
"topOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Notable equipped features, e.g. 'Heated Seats', 'Remote Start'."
},
"mpgCombined": {
"type": "number",
"description": "Not present on every listing observed -- some carry mpgCity/mpgHighway instead."
},
"noAccidents": {
"type": "boolean"
},
"personalUse": {
"type": "boolean"
},
"reliability": {
"type": "object",
"properties": {
"costBadge": {
"type": "string",
"description": "e.g. 'AVERAGE'."
},
"riskBadge": {
"type": "string",
"description": "e.g. 'AVERAGE'."
},
"averageCost": {
"type": "number",
"description": "Estimated average annual repair cost, USD."
},
"reliabilityPlacement": {
"type": "number",
"description": "A percentile ranking."
},
"overallReliabilityBadge": {
"type": "string",
"description": "e.g. 'GOOD'."
}
},
"additionalProperties": true
},
"stockNumber": {
"type": "string",
"description": "The dealer's own inventory reference number for this vehicle."
},
"chicletBadge": {
"type": "string",
"description": "A short highlight label, e.g. 'Low Mileage', 'High Demand'."
},
"currentPrice": {
"type": "number",
"description": "The current asking price, USD -- equal to listPrice on every real call observed."
},
"displacement": {
"type": "string"
},
"ownerHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'CARFAX 1-Owner'."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "General location of this owner, not a person's identity."
},
"state": {
"type": "string"
},
"ownerNumber": {
"type": "number"
},
"purchaseDate": {
"type": "string"
},
"endOwnershipDate": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"priceHistory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"listPrice": {
"type": "number"
},
"difference": {
"type": "number",
"description": "USD change from the previous entry."
}
},
"additionalProperties": true
},
"description": "Present on some listings only -- a list of price changes for this listing."
},
"transmission": {
"type": "string"
},
"vehiclePrice": {
"type": "number",
"description": "A separate vendor-computed price figure, USD, distinct from listPrice on real calls observed."
},
"exteriorColor": {
"type": "string"
},
"interiorColor": {
"type": "string"
},
"listingStatus": {
"type": "string"
},
"reliabilityV2": {
"type": "object",
"properties": {
"reliabilityImpactFactors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"subText": {
"type": "string"
},
"descriptiveText": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Plain-language reliability factors, e.g. repair cost and oil-change history."
}
},
"additionalProperties": true
},
"onePriceArrows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'No Accidents Reported', '1-Owner Vehicle'."
},
"arrow": {
"type": "string",
"description": "'UP' or 'DOWN', direction of price impact."
},
"order": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Short reasons the vehicle qualifies for its onePrice figure."
},
"serviceHistory": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"number": {
"type": "number",
"description": "Count of documented service records."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"date": {
"type": "string"
},
"state": {
"type": "string"
},
"source": {
"type": "string",
"description": "The servicing business's name and location, e.g. 'City Volkswagen of Evanston, Evanston, IL, '."
},
"description": {
"type": "string"
},
"odometerReading": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"serviceRecords": {
"type": "boolean",
"description": "Whether documented service records exist for this vehicle."
},
"accidentHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'No Accident or Damage Reported'."
},
"accidentSummary": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
},
"distanceToDealer": {
"type": "number",
"description": "Miles from the search location."
},
"vehicleCondition": {
"type": "string",
"description": "e.g. 'Used'."
},
"vehicleUseHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'Personal Use'."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"useType": {
"type": "string"
},
"ownerNumber": {
"type": "number"
},
"averageMilesPerYear": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"monthlyPaymentEstimate": {
"type": "object",
"properties": {
"price": {
"type": "number",
"description": "The vehicle's price used for the estimate, USD."
},
"loanAmount": {
"type": "number",
"description": "USD."
},
"interestRate": {
"type": "number",
"description": "Assumed annual rate, percent."
},
"termInMonths": {
"type": "number"
},
"monthlyPayment": {
"type": "number",
"description": "USD."
},
"downPaymentAmount": {
"type": "number",
"description": "USD."
},
"downPaymentPercent": {
"type": "number"
}
},
"description": "A standard-assumptions monthly payment estimate for this listing.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "The page of matching listings returned by this call (24 on both real calls)."
},
"searchArea": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"description": "The ZIP code the search actually ran against (echoes the input)."
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"radius": {
"type": "number",
"description": "Search radius in miles."
},
"latitude": {
"type": "number",
"description": "Resolved center-point latitude."
},
"longitude": {
"type": "number",
"description": "Resolved center-point longitude."
},
"dynamicRadii": {
"type": "array",
"items": {
"type": "number"
},
"description": "Wider fallback radii (miles) the search can expand to, observed as [50, 100, 200] on both real calls."
}
},
"description": "The resolved search location, echoed back.",
"additionalProperties": true
},
"totalListingCount": {
"type": "number",
"description": "The total number of matching listings in the market, NOT the number of listings in this response's `listings` array (both real calls returned 24 listings while reporting a much larger total, e.g. 40798) -- this call does not paginate through it."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on both real calls observed."
}
},
"description": "The search result.",
"additionalProperties": true
}