Regional Discount & Scarcity Map
Where a brand or model is discounted hardest and where it sells at or above sticker, state by state, with days to sell as the scarcity tell.
This is the technical reference. For the price, a rendered sample and answers to common questions, see the Regional Discount & Scarcity Map product page.
At a glance
| Price | $9.99 per run. |
| Tool name | generate_regional_discount_map |
| Scope | reports:regional-discount-scarcity-map |
| Built for | Automaker |
What it does
The regional discount and scarcity map for one brand, or one model, from Sold Summary API v2 at state grain: every state where at least 25 units left dealer websites in a month of the window (3 months by default), deepest discount first by the gap to sticker (the average advertised asking price at exit against the average listing MSRP), with units over the window, the median days to sell, the median asking price and the priced sample, each state's figures from its latest month with 30 or more priced sales (named in the table). Two flags: Scarcity for a state at or above sticker whose days to sell sit in the fastest quarter of the states, Deep discount for the deepest quarter of gaps. Adds the brand's national sticker-gap line over 12 months with the deepest month and the month nearest sticker, and three findings from the numbers: where the discount is deepest, where sticker holds and scarcity shows, and which way the national gap is moving. New vehicles by default. From the Sold Summary API: a sale is inferred when a listing leaves a US dealer website, every price is the advertised asking price against MSRP at the time the vehicle left the website; incentives, dealer cash and negotiated prices are not observed, so the map is the advertised floor of discounting. Use when a regional, incentive or allocation team asks where a brand or model is discounted hardest, where it holds or beats sticker, which states show scarcity (fast turns at or above sticker), or which way the national gap is moving. Do NOT use for the used-market price map of a nameplate by state (use the Regional Arbitrage Map), for one model's trims (use the Trim Contenting Report), or for brand share against rivals (use Brand Share & Pricing Power). State grain, not ZIP, metro or radius. PRICING: $9.99 per run.
Arguments
| Argument | What it is | Example | |
|---|---|---|---|
make |
Required | The brand (e.g. Nissan). Alone, the map is for the whole brand. | Nissan |
model |
Recommended | A model (e.g. Telluride) to narrow the map to one nameplate. Leave blank for the whole brand. | Rogue |
inventory_type |
Optional | Which market: new (the default) or used. On used vehicles the gap is against the original sticker. | new |
months |
Optional | The window in months, 1 to 12, ending at the latest complete data month (3 by default). A state needs 25 sales in a month for that month to count; units add over the qualifying months and each state's gap is read from its latest month with 30 or more priced sales. | 3 |
What comes back
- Every state where at least 25 units left dealer websites in a month of the window, deepest discount first by the gap to sticker in the state's month read, with units over the window, days to sell, the median asking price, the priced sample and the flag
- Scarcity flags (at or above sticker and in the fastest quarter of turn) and deep-discount flags (the deepest quarter of gaps), with the thresholds stated
- The brand's national gap to sticker over 12 months as a line, with the deepest month and the month nearest sticker
- Three findings from the numbers: where the discount is deepest, where sticker holds and scarcity shows, which way the national gap is moving
- Territories marked, thin samples flagged, a short map says so
- Next steps: the incentive review from the map, the Trim Contenting Report or Brand Share & Pricing Power, a monthly monitor
Asking for it in a chat client
Where is Nissan discounted hardest, and where does it hold sticker?
Regional discount and scarcity map for the Kia Telluride
Running it from a backend
Grant an agent the reports:regional-discount-scarcity-map scope, then call the tool over MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_regional_discount_map",
"arguments": {
"make": "Nissan",
"inventory_type": "new",
"months": 3
}
}
}
See Server-side access for the token exchange and how to read the response.