AI Storefront
Browse the documentation

Run-List Retail Demand Check

For every vehicle on a run list: how many sold at retail in your target states last month, at what price and odometer, how fast, and the lane order.

This is the technical reference. For the price, a rendered sample and answers to common questions, see the Run-List Retail Demand Check product page.

At a glance

Price $0.25 per line delivered. Minimum $2.99 per run. A batch is quoted before it runs: the first call returns a total and charges nothing.
Tool name generate_run_list_demand_check
Scope reports:run-list-retail-demand-check
Built for Auctions & Wholesale, Small Dealer, Dealer Group

What it does

The retail demand check for an auction run list: paste one vehicle per line (year make model, a trim if you have it, or a 17-character VIN, which is decoded) and one to three target states, and every vehicle gets, per state, the units that left dealer websites in the latest data month, the priced sample, the median asking price at exit, the median odometer and the median days to sell. The list comes back in lane order (fastest clearing first, with the state that clears each fastest), with a segment turn-speed table per state (body types with 50 or more sales ranked by median days to sell) and a demand read: coverage of the list, the deepest demand, the fastest and slowest to clear. From the Sold Summary API: a sale is inferred when a listing leaves a US dealer website, every price is the advertised asking price at exit (never a lane, hammer or negotiated price), and the data runs through the latest complete month, one to two months behind the calendar. Use when an auction, remarketer, wholesaler or dealer asks whether the retail market in the lane's draw states is absorbing the vehicles on a run list, at what price level and how fast, or which units to run first. Do NOT use to rank VINs for one dealer's lot (use Acquisition Fit Report), to find the best-fit rooftop for a unit (use Placement Report), or for a state price map of one nameplate (use Regional Arbitrage Map). State grain only, no ZIP or radius; lines are matched on model year, make and model, every trim together. PRICING: metered at $0.25 per vehicle with retail sales in at least one target state, with a $2.99 minimum, up to 200 lines per run; lines that cannot be read, vehicles with no sales in the target states, and a vehicle pasted more than once (looked up once) are not billed. A list that could cost more than $2.99 requires cost confirmation: call first WITHOUT confirm_cost_usd for an up-to quote (this charges nothing and warms the data), then again with confirm_cost_usd set to the quoted cap once the user approves.

Arguments

Argument What it is Example
lines Required One vehicle per line as year make model with an optional trim (e.g. "2021 Ford F-150 XLT"), or a 17-character VIN, which is decoded to its year, make and model. A lot number before the year, or a "ref | vehicle" form, is kept as the line's reference. Up to 200 lines. Metered at $0.25 per vehicle with retail sales in at least one target state, $2.99 minimum. 2021 Ford F-150 XLT
target_states Required One to three US states the lanes draw from, as 2-letter codes separated by commas (e.g. TX, OK, AR). The sold data has state grain only, no ZIP or radius. TX, OK, AR
inventory_type Recommended Which market: used (the default), new, or certified pre-owned. used
months Optional Whole months to count units over, ending at the latest data month: 1 by default (the latest month), up to 3. The medians always describe the latest month with 5 or more priced sales. 1
confirm_cost_usd Optional Only for a list that could cost more than the $2.99 floor (12 lines or more). After quoting the user the up-to cap and getting approval, call again with this set to the quoted cap. Charged only for vehicles with retail sales, never above the cap. Leave empty on the first (quote) call. 10

What comes back

Asking for it in a chat client

Check retail demand for this run list in TX, OK and AR (paste list)

Which of these 40 units sell fastest at retail in Georgia?

Running it from a backend

Grant an agent the reports:run-list-retail-demand-check scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_run_list_demand_check",
    "arguments": {
      "lines": "2021 Ford F-150 XLT\n2022 Chevrolet Silverado 1500 LT\n2020 Toyota Tacoma\n2021 Jeep Grand Cherokee\n2019 Honda CR-V\n2022 Porsche 911",
      "target_states": "TX, GA",
      "inventory_type": "used"
    }
  }
}

See Server-side access for the token exchange and how to read the response.