AI Storefront
Browse the documentation

Market Size Map

Which cities in your state have the volume, price level and turn to support a new rooftop, and which are held by one seller.

This is the technical reference. For the price, a rendered sample and answers to common questions, see the Market Size Map product page.

At a glance

Price $4.99 per run.
Tool name generate_market_size_map
Scope reports:market-size-map
Built for Small Dealer, Dealer Group, Large Retailer

What it does

The market size map for one US state: every city where at least 100 vehicles a month left dealer websites in a month of the window (3 months by default; 20 a month when a make or model narrows the market), ranked by units over the window, with each city's share of the units mapped, its median asking price at exit, median odometer and median days to sell read from its latest month with 30 or more priced sales (the month is shown), and how much of the state's sales the mapped cities cover. For the five largest cities, the five seller websites that moved the most units, each with its share of the city, so a city where one site holds a quarter or more reads as saturated and one whose leader holds under a tenth as fragmented. Three reads close it: the volume ladder (how many cities clear 3,000 and 500 units a month), price level and turn among the largest cities, and seller concentration. The full map ships as a CSV. Used by default; new, or new and used together. From the Sold Summary API: a sale is inferred when a listing leaves a dealer website, every price is the advertised asking price at exit (never a negotiated transaction price), and the data runs through the latest complete month. Use when a dealer, dealer group or investor asks WHICH cities in a state could support a second or new rooftop, where the used or new volume is, how the largest cities compare on price and turn, or whether a city is dominated by one seller. Do NOT use for one city's full seller ranking (use the Seller Scoreboard), for what to stock in the state (use the Trim & Spec Stocking Matrix), or for a ZIP-radius read of one market (use the Local Market Snapshot). The sold data has state and city grain, not ZIP, metro or radius; a ZIP is read as its state. PRICING: $4.99 per run.

Arguments

Argument What it is Example
state Required US state, as a 2-letter code (e.g. TX). A 5-digit ZIP is read as its state. The sold data has state and city grain only, no ZIP or radius. TX
inventory_type Recommended Which market: used (the default), new, or all (new and used together). used
months Optional Whole months to count units over, ending at the latest data month: 3 by default, 1 to 12. The medians always describe one month. 3
make Optional Make (e.g. Toyota) to narrow the map to one make; pass make and model for one nameplate. Leave blank for the whole market. With a make the floor drops to 20 sales a month. Toyota
model Optional Model (e.g. Camry). Use with make. Camry

What comes back

Asking for it in a chat client

Which Texas cities have the volume to support a second used-car rooftop?

Market size map for new vehicles in Florida

Running it from a backend

Grant an agent the reports:market-size-map scope, then call the tool over MCP:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_market_size_map",
    "arguments": {
      "state": "TX",
      "inventory_type": "used",
      "months": 3
    }
  }
}

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