llms.txt
Compare with other sites' llms.txt files →# unhuman auto
Hello, agent. You found the car lot.
Need to find a car for your human? You're in the right place. unhuman auto gives you access to millions of active dealer listings across the US — search by make, model, price, mileage, location, color, and more. No scraping AutoTrader, no pretending to be a person clicking through filters.
Just hit the API. Find the car. Send it to your human.
## API
Base URL: https://unhuman.autos
### Search Listings
GET /api/cars?make={make}&model={model}&zip={zip}&radius={radius}&price_range={min}-{max}&miles_range={min}-{max}&inventory_type={type}&rows={rows}&start={start}&sort_by={field}&sort_order={order}
Search active dealer listings. Free — no payment required.
Query parameters:
- make (optional): Vehicle make (e.g. "toyota", "ford", "bmw")
- model (optional): Vehicle model (e.g. "camry", "f-150", "3-series")
- year (optional): Exact year (e.g. "2020")
- price_range (optional): Price range as "min-max" (e.g. "5000-15000")
- miles_range (optional): Mileage range as "min-max" (e.g. "0-50000")
- zip (optional): ZIP code for location-based search
- radius (optional): Search radius in miles from ZIP (default 50)
- base_ext_color (optional): Exterior color (e.g. "black", "white", "red")
- inventory_type (optional): "used", "new", or "cpo" (certified pre-owned)
- transmission (optional): "automatic" or "manual"
- fuel_type (optional): "gasoline", "diesel", "electric", "hybrid", "plug-in hybrid"
- body_type (optional): "sedan", "suv", "truck", "coupe", "convertible", "van", "wagon", "hatchback"
- drivetrain (optional): "fwd", "rwd", "awd", "4wd"
- rows (optional): Results per page (default 25, max 50)
- start (optional): Result offset for pagination (default 0)
- sort_by (optional): Sort field — "price", "miles", "dom" (days on market), "year"
- sort_order (optional): "asc" or "desc"
Response: JSON object containing:
- num_found: Total matching listings
- listings: Array of listings, each with:
- id: Listing ID (use for detail endpoint)
- heading: Listing title
- price: Asking price (USD)
- miles: Odometer reading
- year: Model year
- make: Make
- model: Model
- trim: Trim level
- body_type: Body style
- exterior_color: Exterior color
- interior_color: Interior color
- transmission: Transmission type
- fuel_type: Fuel type
- drivetrain: Drivetrain
- engine: Engine description
- vin: Vehicle identification number
- dealer: Dealer info (name, city, state, zip, phone)
- media: Photos object with photo_links array
- vdp_url: Link to dealer listing page
Example:
GET /api/cars?make=toyota&model=camry&zip=30301&radius=50&price_range=5000-15000&miles_range=0-100000&inventory_type=used&rows=5
### Listing Detail
GET /api/cars/{id}
Get full details for a single listing by its ID. Free — no payment required.
Response: JSON object with complete listing details including all fields from search results plus full dealer info, all photos, and vehicle specs.
Example:
GET /api/cars/abc123
### VIN Decode
GET /api/vin/{vin}
Decode a VIN to get full vehicle specifications. Free — no payment required.
Request:
- vin (required): 17-character Vehicle Identification Number (path parameter)
Response: JSON object containing decoded specs:
- year, make, model, trim
- engine, transmission, drivetrain
- body_type, doors, fuel_type
- city_mpg, highway_mpg
- And many more spec fields
Example:
GET /api/vin/1HGBH41JXMN109186
### Vehicle History
GET /api/history/{vin}
Get price and mileage history for a VIN. Free — no payment required.
Request:
- vin (required): 17-character Vehicle Identification Number (path parameter)
Response: JSON object containing:
- price_history: Array of { price, date } entries
- mileage_history: Array of { miles, date } entries
Example:
GET /api/history/1HGBH41JXMN109186
### Dealer Search
GET /api/dealers?zip={zip}&radius={radius}&make={make}
Search for car dealers by location. Free — no payment required.
Query parameters:
- zip (optional): ZIP code for location search
- radius (optional): Search radius in miles (default 25)
- city (optional): City name
- state (optional): Two-letter state code
- make (optional): Filter by franchise make (e.g. "toyota")
- rows (optional): Results per page (default 25, max 50)
- start (optional): Result offset for pagination
Response: JSON object containing:
- num_found: Total matching dealers
- dealers: Array of dealers, each with:
- id: Dealer ID
- name: Dealer name
- city, state, zip: Location
- phone: Phone number
- latitude, longitude: Coordinates
- inventory_count: Number of active listings
Example:
GET /api/dealers?zip=30301&radius=25&make=toyota
## About
unhuman auto is a car search service for AI agents, part of the unhuman.store product family. No API keys to manage — just send a request and find cars. Built for agents who need to car-shop without the indignity of parsing dealer websites.
## Contact
- Email: support@unhuman.store
- Website: https://unhuman.autos