Skip to content
Eden Engine

Vehicle Auction Listings Search (by Make, Model, Year & Status)

omnial/search-listings

Search live and ended vehicle auction listings by make, model, year range, status, and auction type, one paginated page (up to 50 listings) per call. Each listing carries the vehicle title, VIN, odometer, damage/loss type, seller, sale-document status, current or final bid, and buy-now price. Set get_count to return a single count summary (active, live, ended, fast-buy, and total listing counts) instead of listing rows.

activeper callv1
Provider
Web & Business Data Network
Category
automotive
Provider price
$0.01365 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "make"
      ]
    },
    {
      "required": [
        "model"
      ]
    },
    {
      "required": [
        "year_from"
      ]
    },
    {
      "required": [
        "year_to"
      ]
    },
    {
      "required": [
        "status"
      ]
    },
    {
      "required": [
        "auction_type"
      ]
    },
    {
      "required": [
        "get_count"
      ]
    },
    {
      "required": [
        "page"
      ]
    }
  ],
  "properties": {
    "make": {
      "type": "string",
      "description": "Vehicle make filter. Use 'All' for no make filter."
    },
    "page": {
      "type": "integer",
      "description": "Page number for pagination."
    },
    "model": {
      "type": "string",
      "description": "Vehicle model filter. Use 'All' for no model filter."
    },
    "status": {
      "type": "string",
      "description": "Listing status filter."
    },
    "year_to": {
      "type": "string",
      "description": "Maximum model year."
    },
    "get_count": {
      "type": "string",
      "description": "Set to 'true' to return a count summary object instead of listing data."
    },
    "year_from": {
      "type": "string",
      "description": "Minimum model year."
    },
    "auction_type": {
      "type": "string",
      "description": "Auction type filter."
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "required": [
    "status",
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "to": {
          "type": "integer"
        },
        "data": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "lot": {
                "type": "string",
                "description": "The vendor's own lot identifier, e.g. '0-45983127'."
              },
              "tag": {
                "type": "string",
                "description": "A URL-safe slug of the title plus VIN."
              },
              "vin": {
                "type": "string"
              },
              "name": {
                "type": "string",
                "description": "The listing's vehicle title, e.g. '2001 Toyota Sienna, LE' -- year, make, model, and trim, not a person's name."
              },
              "type": {
                "type": "string",
                "description": "e.g. 'Automobile'."
              },
              "specs": {
                "type": "object",
                "properties": {
                  "hybrid": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "key_info": {
                    "type": "string"
                  },
                  "fuel_type": {
                    "type": "string"
                  },
                  "drive_type": {
                    "type": [
                      "integer",
                      "null"
                    ]
                  },
                  "transmission": {
                    "type": "integer"
                  },
                  "engine_rendered": {
                    "type": "string",
                    "description": "Free-text engine summary."
                  }
                },
                "additionalProperties": false
              },
              "seller": {
                "type": "string",
                "description": "Truncated seller/insurer name."
              },
              "status": {
                "type": "integer",
                "description": "A vendor status code; every row observed was 2."
              },
              "location": {
                "type": "string",
                "description": "City and state/province abbreviation."
              },
              "odometer": {
                "type": "integer"
              },
              "final_bid": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Null when the lot has not closed with a winning bid yet."
              },
              "has_video": {
                "type": "boolean"
              },
              "loss_type": {
                "type": "string",
                "description": "e.g. 'Collision', 'Other'."
              },
              "name_long": {
                "type": "string",
                "description": "The same vehicle title, observed identical to `name` on every row."
              },
              "time_left": {
                "type": "string"
              },
              "start_code": {
                "type": "string",
                "description": "Vendor-reported starting condition, e.g. 'Run / Drive'."
              },
              "seller_long": {
                "type": "string",
                "description": "Untruncated seller/insurer name."
              },
              "sold_before": {
                "type": "integer"
              },
              "has_360_view": {
                "type": "boolean"
              },
              "prebid_price": {
                "type": "string",
                "description": "Formatted currency string, e.g. '$0'."
              },
              "buy_now_price": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Formatted currency string, or null when no buy-now offer applies."
              },
              "estimated_max": {
                "type": "integer"
              },
              "estimated_min": {
                "type": "integer"
              },
              "sale_document": {
                "type": "string",
                "description": "e.g. 'Clear', 'Salvage'."
              },
              "search_status": {
                "type": "string",
                "description": "e.g. 'ended'."
              },
              "primary_damage": {
                "type": "string"
              },
              "seller_trusted": {
                "type": "integer",
                "description": "0 or 1 on every row observed."
              },
              "title_has_lien": {
                "type": "integer"
              },
              "odometer_substr": {
                "type": "integer",
                "description": "Odometer rounded to thousands of miles."
              },
              "start_code_color": {
                "type": "string"
              },
              "buy_now_close_time": {
                "type": [
                  "integer",
                  "string"
                ],
                "description": "Unix timestamp when observed as a number; the vendor also emits the literal '0' as a string for some rows."
              },
              "odometer_km_substr": {
                "type": "integer",
                "description": "Odometer rounded to thousands of kilometers."
              },
              "final_bid_formatted": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "sale_document_split": {
                "type": "string"
              },
              "sale_document_state": {
                "type": "string"
              },
              "time_left_formatted": {
                "type": "string"
              },
              "prebid_close_time_lang": {
                "type": "object",
                "properties": {
                  "en": {
                    "type": "string"
                  },
                  "pl": {
                    "type": "string"
                  },
                  "ru": {
                    "type": "string"
                  },
                  "ua": {
                    "type": "string"
                  }
                },
                "description": "The prebid close time, pre-rendered in four languages.",
                "additionalProperties": false
              },
              "sale_document_external": {
                "type": "string"
              },
              "sale_document_external_status": {
                "type": "integer"
              }
            },
            "additionalProperties": false
          },
          "description": "Present only on a listing-search call. Up to 50 rows per page."
        },
        "from": {
          "type": "integer"
        },
        "count": {
          "type": "object",
          "properties": {
            "all": {
              "type": [
                "integer",
                "null"
              ]
            },
            "live": {
              "type": [
                "integer",
                "null"
              ]
            },
            "ended": {
              "type": [
                "integer",
                "null"
              ]
            },
            "active": {
              "type": [
                "integer",
                "null"
              ]
            },
            "fast-buy": {
              "type": [
                "integer",
                "null"
              ]
            }
          },
          "description": "Present only on a get_count=true call. On the one real call observed every leaf came back JSON null (a query with no matching listings for the given filters) -- the vendor's own field names imply an integer count when populated, but a populated numeric example was never captured, so every leaf below stays nullable rather than claimed as guaranteed-integer.",
          "additionalProperties": false
        },
        "per_page": {
          "type": "integer"
        },
        "current_page": {
          "type": "integer"
        }
      },
      "description": "Pagination metadata plus one of data.data[] or data.count.",
      "additionalProperties": false
    },
    "status": {
      "type": "string",
      "description": "'success' on both real calls observed."
    }
  },
  "description": "The narrowed response at $.output. Listing-search calls populate data.data[]; get_count=true calls populate data.count instead -- a given call returns only one of the two.",
  "additionalProperties": false
}

Pricing

Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.

Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.

ChargeRate
Per call
Flat, regardless of what comes back
$0.01365
Cost basis
Not recorded

This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.

Updated
Sep 23, 2026