Skip to content

Savvy API (Canonical Inventory)

Repo: internal / infrastructure — see ~/.claude/projects/C--Users-adam/memory/project_savvy_incentive_api.md · Path: N/A (hosted service) · Owner: Adam Status: Live · % Done: n/a (production) · Last commit: n/a (not a code repo tracked here)

What it is

The canonical internal inventory + incentive API for SavvyDealer. Returns vehicle inventory by site ID and per-VIN incentive data. Replaces ad-hoc scraping and Google Sheets as the inventory source of truth.

Why it exists

Inventory and pricing were scattered across scrapers, spreadsheets, and vendor feeds — leading to drift and bad dealer-facing numbers. Savvy API is the one place to read current inventory + incentives. Rule: use sellingPrice from this API, never Google Sheets.

How it works

Production HTTP API. - Inventory endpoint keyed by site ID - Incentive data keyed by VIN - sellingPrice is the canonical price field - Replaces OEM / dealer-site scraping wherever possible

What's done

  • Production deploy (in use across SavvyDealer tools)
  • Inventory-by-site-ID path live
  • Incentive-by-VIN path live
  • Canonical sellingPrice contract

What's next

  • Broaden dealer coverage (still scraping for dealers not yet on the API)
  • Keep Lease Scraper + demo / page-builder pipelines pointed here, not at Sheets
  • Document client library + auth pattern in a public-internal reference

Where the code lives

  • Service hosted (not a tracked GitHub repo in this portfolio)
  • Memory / context: ~/.claude/projects/C--Users-adam/memory/project_savvy_incentive_api.md
  • Related feedback: feedback_use_savvy_api_not_sheets.md

Integrations

  • Canonical inventory source for: Lease Scraper, Savvy Demo, Savvy Page Builder, demo dealer sites, ad builders, competitive dashboard
  • Replaces: dealer-site scraping, Google Sheets inventory reads

Don't rebuild this — extend it

If you need inventory or pricing for any SavvyDealer tool, call Savvy API. Do not read Google Sheets and do not scrape the dealer site.