dealer-direct-inventory

Search live dealer-direct New, Used, and Certified Pre-Owned car inventory across Miami and South Florida dealerships. Supports natural free-text query, condition ('new', 'used', 'certified'), make, model, trim, year_min/year_max, price_max, mileage_max, zip + radius_miles (geo search), fuel_type, drivetrain, transmission, body_style, certified_only, and dealer_id. Every vehicle includes freshness timestamps (last_seen_at) and a direct link to the dealer's own VDP (source_url). Empty searches return closest-match suggestions.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional free-text search query (e.g., 'new SUV', 'used AWD', 'Ford Explorer', 'Honda Civic')."
    },
    "condition": {
      "type": "string",
      "enum": [
        "new",
        "used",
        "certified"
      ],
      "description": "Filter by vehicle condition ('new', 'used', or 'certified'). Omit to search all conditions."
    },
    "state": {
      "type": "string",
      "description": "2-letter US state code filter (e.g., 'FL', 'TX', 'GA', 'NC', 'AZ', 'CA', 'IL', 'MI', 'NJ')."
    },
    "city": {
      "type": "string",
      "description": "City name filter (e.g., 'Miami', 'Orlando', 'Tampa', 'Jacksonville', 'Atlanta', 'Austin', 'Houston', 'Phoenix')."
    },
    "region": {
      "type": "string",
      "description": "Regional market filter (e.g., 'South Florida', 'Central Florida', 'Tampa Bay', 'North Florida', 'Atlanta', 'Texas', 'Carolinas', 'West')."
    },
    "make": {
      "type": "string",
      "description": "Vehicle make (e.g., 'BMW', 'Toyota', 'Mazda', 'Tesla', 'Audi', 'Ford')."
    },
    "model": {
      "type": "string",
      "description": "Vehicle model (e.g., 'CX-30', 'Model Y', 'Camry', 'X2', '3 Series')."
    },
    "trim": {
      "type": "string",
      "description": "Vehicle trim or submodel (e.g., 'Long Range', 'xDrive28i', 'SE')."
    },
    "year_min": {
      "type": "integer",
      "description": "Minimum model year (e.g., 2020)."
    },
    "year_max": {
      "type": "integer",
      "description": "Maximum model year (e.g., 2026)."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum advertised price in USD (e.g., 25000)."
    },
    "mileage_max": {
      "type": "integer",
      "description": "Maximum odometer mileage in miles (e.g., 60000)."
    },
    "zip": {
      "type": "string",
      "description": "5-digit US ZIP code for geo-radius search (e.g., '33140' for Miami Beach, '33169' for Miami Gardens)."
    },
    "radius_miles": {
      "type": "number",
      "description": "Search radius in miles from the ZIP centroid (default: 25, max: 500)."
    },
    "fuel_type": {
      "type": "string",
      "description": "Fuel type filter ('Gasoline', 'Hybrid', 'Electric', 'Plug-In Hybrid', 'Diesel')."
    },
    "drivetrain": {
      "type": "string",
      "description": "Drivetrain filter ('AWD', 'FWD', 'RWD', '4WD')."
    },
    "transmission": {
      "type": "string",
      "description": "Transmission filter (e.g., 'Automatic', 'Manual')."
    },
    "body_style": {
      "type": "string",
      "description": "Vehicle body style ('SUV', 'Sedan', 'Truck', 'Coupe', 'Convertible', 'Hatchback', 'Van')."
    },
    "certified_only": {
      "type": "boolean",
      "description": "If true, only return factory Certified Pre-Owned (CPO) vehicles."
    },
    "dealer_id": {
      "type": "string",
      "description": "Filter by specific dealer ID (e.g., 'dealer_north_miami_mitsubishi')."
    },
    "sort_by": {
      "type": "string",
      "enum": [
        "price",
        "price_asc",
        "price_desc",
        "mileage",
        "distance",
        "newest"
      ],
      "description": "Sort order for results (default: 'price')."
    },
    "limit": {
      "type": "integer",
      "description": "Max vehicles to return per page (1-100, default: 20)."
    },
    "page": {
      "type": "integer",
      "description": "Page number for pagination (1-based, default: 1)."
    }
  },
  "additionalProperties": false
}

Retrieve the complete canonical record for a single vehicle by its vehicle_id or 17-character VIN. Returns full specifications, pricing breakdown & fee disclosures, price history, all high-res photo URLs, dealer contact info, and source_url back to the dealer's VDP.

{
  "type": "object",
  "properties": {
    "id_or_vin": {
      "type": "string",
      "description": "The canonical vehicle ID (e.g., 'veh_north-miami-mitsubishi_...') or 17-character VIN (e.g., '3MVDMBBM7SM754223')."
    }
  },
  "required": [
    "id_or_vin"
  ],
  "additionalProperties": false
}

List all indexed dealerships on the platform across 9 US regions and states, their physical locations, website platforms, last crawl timestamps, live available New and Used inventory counts, and price ranges.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Optional 2-letter US state filter (e.g., 'FL', 'TX', 'GA', 'NC', 'AZ', 'CA', 'IL', 'MI', 'NJ')."
    },
    "region": {
      "type": "string",
      "description": "Optional regional market filter (e.g., 'South Florida', 'Orlando', 'Tampa Bay', 'Atlanta', 'Texas')."
    }
  },
  "additionalProperties": false
}

Submit a buyer inquiry/lead directly to a participating dealership for a specific vehicle or general inventory inquiry. Requires explicit buyer consent (consent=true) and at least one contact method (buyer_email or buyer_phone). Returns a lead_id and delivery status.

{
  "type": "object",
  "properties": {
    "vehicle_id": {
      "type": "string",
      "description": "Vehicle ID or 17-character VIN the buyer is inquiring about."
    },
    "dealer_id": {
      "type": "string",
      "description": "Dealer ID (optional if vehicle_id is provided; required for general dealer inquiries)."
    },
    "buyer_name": {
      "type": "string",
      "description": "Full name of the prospective buyer."
    },
    "buyer_email": {
      "type": "string",
      "description": "Buyer's email address (at least one of buyer_email or buyer_phone is required)."
    },
    "buyer_phone": {
      "type": "string",
      "description": "Buyer's phone number (at least one of buyer_email or buyer_phone is required)."
    },
    "message": {
      "type": "string",
      "description": "Buyer's intent, questions, test-drive request, or trade-in/insurance notes."
    },
    "consent": {
      "type": "boolean",
      "description": "Explicit buyer consent flag. Must be true to create and deliver the lead to the dealership."
    }
  },
  "required": [
    "buyer_name",
    "consent"
  ],
  "additionalProperties": false
}

Check the delivery state, webhook/email attempts, duplicate flag, and billing ledger status of a submitted lead. Requires dealer_api_key.

{
  "type": "object",
  "properties": {
    "lead_id": {
      "type": "string",
      "description": "The unique lead ID returned by submit_lead."
    },
    "dealer_api_key": {
      "type": "string",
      "description": "Dealer API key for authentication."
    }
  },
  "required": [
    "lead_id",
    "dealer_api_key"
  ],
  "additionalProperties": false
}