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
- Every city on the floor (100 sales a month; 20 for a nameplate), ranked by units over the window, with its share of the units mapped, median asking price at exit, median odometer and days to sell from its latest month with an adequate sample, and how much of the state the map covers
- The five seller websites that moved the most units in each of the five largest cities, with each site's share of the city; a city held a quarter or more by one site reads as saturated, a leader under a tenth as fragmented
- The volume ladder: how many cities clear 3,000 and 500 units a month, and where the map ends
- Price level and turn among the largest cities: the highest and lowest median, the fastest and slowest turn
- Key metrics: cities and units mapped, the share of the state covered, the largest city and its share, the floor and the data window
- A CSV of every city, and next steps: the Seller Scoreboard for a city's full ranking, the Trim & Spec Stocking Matrix for the mix, a monthly monitor
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.