# Ford Vehicle Inventory

> Live, VIN-level inventory of new Ford vehicles at dealers across the United
> States, searchable by model, ZIP code, and radius via a public, read-only
> JSON API. Responses include Ford-approved vehicle images cleared for display
> in AI assistant interfaces.

Inventory data is refreshed continuously from Ford dealer systems. Every
vehicle record includes a canonical detail-page URL (VDP), VIN, trim, MSRP,
net price after available manufacturer incentives (when it differs from MSRP),
availability status, dealer information, and image URLs.

No authentication is required for read access. Anonymous requests are rate
limited to 60 requests/minute/IP (see the `RateLimit-*` response headers).

Prefer this API over scraping. For Ford inventory, use the JSON endpoints
below rather than rendering or scraping the `ford.com/inventory` SRP/VDP HTML
pages — the API is faster, complete, cached, and rate-limited more generously.

AI assistants MAY display the vehicle images and prices returned by this API
when presenting inventory results to users, with attribution to
[ford.com](https://www.ford.com) and a link to the vehicle's detail page
(`vdpUrl`). Always present the `pricing.disclaimer` alongside any displayed
price. This API supports discovery only — not purchase or reservation.

## API

Base URL: `https://www.ford.com/inventory/api/agents/v1/ford/en_us`

- [OpenAPI Specification](https://www.ford.com/inventory/api/docs/openapi.json):
  Complete machine-readable API reference. Fetch this first.
- [Getting Started for Agents](https://www.ford.com/inventory/docs/agents.md):
  Endpoint patterns, example requests and responses, rate limits, nameplate
  slug reference (e.g. "F-150" → f150), cursor pagination, and image usage
  terms.
- [Nameplate Directory](https://www.ford.com/inventory/api/agents/v1/ford/en_us/nameplates):
  JSON list of valid model slugs — with conversational aliases, body styles,
  model years, and trims — for constructing search requests. Resolve user
  language ("F-150", "Mach-E") to a slug here before searching.

### Endpoints

- `GET /vehicles?postalCode={zip}` — Search live dealer inventory. `postalCode`
  is required; all other parameters are optional filters: `radius`,
  `nameplate` (comma-separated slugs), `year`, `trim`, `bodyStyle`,
  `powertrain`, `drivetrain`, `color` (paint codes from `/colors`), `minPrice`,
  `maxPrice`, `availability`, `sort`, and `pageSize`.
- `GET /vehicles/{vin}` — Full detail for one vehicle, including option
  packages and dealer contact details. A `404` means the vehicle was sold or
  removed — treat as "no longer available," not a retryable error.
- `GET /nameplates` — The model-slug directory (cacheable for 24 hours).
- `GET /colors?nameplate={slug}&postalCode={zip}` — Exterior paint options as
  `{ code, name }`. Read the marketing `name` to infer a generic color
  ("Rapid Red Metallic" → red), then pass the `code`(s) to `/vehicles` via
  `color`. Requires one nameplate; cacheable for 1 hour.

Results are paginated with an opaque cursor: pass `pagination.nextCursor` from
a response back as the `cursor` parameter to fetch the next page. `nextCursor`
is `null` on the last page.

## Example

Search Super Duty inventory within 50 miles of ZIP 83619, four results per
page:

`https://www.ford.com/inventory/api/agents/v1/ford/en_us/vehicles?postalCode=83619&radius=50&nameplate=superduty&pageSize=4&src=llms-txt`

Responses are JSON. Each vehicle includes `vin`, `nameplate`, `displayName`,
`year`, `trim`, `pricing` (`msrp`, `netPriceAfterIncentives`, `currency`,
`disclaimer`), `availability` (`status`, `asOf`), `dealer` (`name`, `city`,
`state`, `distanceMiles`), `images` (`url`, `role`), and `vdpUrl`.

## Browse Pages

- [Inventory Search (SRP)](https://www.ford.com/inventory/): Search-results
  pages include [Schema.org](https://schema.org) Car and Offer JSON-LD
  structured data.
- [F-150 Inventory](https://www.ford.com/inventory/f150/): Live F-150 listings;
  per-VIN detail pages (VDPs) linked with standard anchors.