# LotPilot Discovery API

LotPilot is a multi-dealer vehicle inventory platform. Canonical consumer
pages live at https://lotpilot.com — this API serves the structured
data behind them and is designed for AI agents (ChatGPT, Perplexity,
Gemini, Bing, Google) to crawl directly.

## Public Inventory Feeds (cache >= 10 minutes please)
- https://discovery-api.lotpilot.com/api/discovery/inventory.json                  full bulk feed of in-stock vehicles
- https://discovery-api.lotpilot.com/api/discovery/dealers/{slug}/inventory.json   per-dealer feed
- https://discovery-api.lotpilot.com/api/discovery/vehicles/by-vin/{vin}           single vehicle by VIN
- https://discovery-api.lotpilot.com/api/discovery/inventory-feed.xml              RSS 2.0 feed

Each vehicle includes year, make, model, trim, VIN, price, mileage,
condition, body type, fuel type, transmission, drivetrain, exterior +
interior color, fuel efficiency, image URLs, an AI-generated description,
and a canonical URL on www.lotpilot.com. The dealer object includes
name, phone, city, state, postal code, and a description summarizing
inventory composition + service area.

## AI-Generated Content
- https://discovery-api.lotpilot.com/api/discovery/ai-content/{topic}              comparison + decision-logic + FAQ blob
  Topics include: best-{year}-{make}-{model}-{city}-{state},
  best-{bodyType}-under-{price}-{city}-{state},
  used-cars-{city}-{state}, used-{bodyType}-{state},
  used-{make}-{city}-{state}, cars-{make}-{model},
  near-me-{make}, near-me-{make}-{model},
  and buyer-question slugs.
  Pass ?generate=true to trigger on-demand generation if missing.
- https://discovery-api.lotpilot.com/llms-full.txt                                 full AI content corpus, one Markdown doc

## Vehicle / Dealer / Search (canonical FE pages)
- https://discovery-api.lotpilot.com/api/discovery/inventory/{dealer-slug}/{vehicle-slug}   single vehicle (with JSON-LD)
- https://discovery-api.lotpilot.com/api/discovery/inventory/{dealer-slug}                  per-dealer hub
- https://discovery-api.lotpilot.com/api/discovery/inventory/search                          cross-dealer search + facets

## Sitemap
- https://lotpilot.com/sitemap.xml                                             canonical URL set (vehicle + topic pages)
- https://discovery-api.lotpilot.com/api/discovery/inventory/slugs                          slug-only list, for cache priming

## Data Format
- JSON for everything except /inventory-feed.xml (RSS)
- Vehicle condition: new | used | certified
- Vehicle status: in_stock | sold | removed
- Updates twice daily via inventory sync
- dateModified is included in JSON-LD on every vehicle page

## Pilot
Active pilot dealers: Capitol Nissan Infiniti (San Jose, CA),
Unique Drive (West Babylon, NY).

## Contact
For partner API access: https://lotpilot.com

## Consumer Pages

- [Car Inventory Search](https://lotpilot.com/inventory): Browse and filter thousands of new and used vehicles from verified U.S. dealers.
- [Cars by Make](https://lotpilot.com/cars): AI-generated guides for every major make — Toyota, Ford, BMW, Tesla, and more.
- [Cars Near Me](https://lotpilot.com/near-me): Find vehicles from local dealers by make and model.
- [Blog](https://lotpilot.com/blogs): Car-buying guides, market insights, and AI-powered research from the LotPilot team.
- [Help Center](https://lotpilot.com/help): Answers to common car-shopping questions.
- [About LotPilot](https://lotpilot.com/about): How LotPilot works and why it's different from traditional listing portals.
- [Contact](https://lotpilot.com/contact): Talk to the LotPilot team.
- [Full Sitemap](https://lotpilot.com/sitemap.xml): Complete URL index including all vehicle, topic, and hub pages.

## AI Corpus

- [Full AI Content](https://discovery-api.lotpilot.com/llms-full.txt): Complete AI-generated content corpus — make/model guides, city-level data, FAQs.
- [Bulk Vehicle Feed](https://discovery-api.lotpilot.com/api/discovery/inventory.json): Structured JSON feed of all in-stock vehicles across all dealers.