# 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. It proxies the MarketCheck API (api.marketcheck.com/v2) so you don't have to manage API keys — 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