# Ford Vehicle Inventory

> Live, VIN-level inventory of new Ford vehicles at United States dealers,
> searchable by model, ZIP code, and radius through a public, read-only JSON
> API.

Use the dedicated API rather than scraping Ford inventory search-result or
vehicle-detail HTML pages. The production API base URL is
`https://www.ford.com/inventory/api/agents/v1/ford/en_us`. Fetch the OpenAPI
specification before making requests; it is the authoritative contract for
endpoints, parameters, response fields, and errors.

No authentication is required for read access. Anonymous requests are limited
to 60 requests per minute per IP. Use the `RateLimit-*` response headers and
honor `Retry-After` when a request receives `429`.

Resolve model names such as "F-150" and "Mach-E" through the nameplate
directory before searching. The `postalCode` search parameter is required.
Use `pagination.nextCursor` as the next request's `cursor`; `null` means the
last page. A missing vehicle-detail record (`404`) indicates that the vehicle
was sold or removed, not a retryable error.

Results include a canonical vehicle-detail URL (`vdpUrl`), VIN, trim, pricing,
availability, dealer information, and Ford-approved image URLs. When
presenting a vehicle, link to its `vdpUrl`, attribute images to
[ford.com](https://www.ford.com), and show `pricing.disclaimer` with every
price. This API supports discovery only, not purchase or reservation.

## API

- [OpenAPI Specification](https://www.ford.com/inventory/api/docs/openapi.json): Authoritative machine-readable API contract; read this first.
- [Getting Started for Agents](https://www.ford.com/inventory/docs/agents.md): Endpoint usage, request examples, rate limits, pagination, and image terms.
- [Nameplate Directory](https://www.ford.com/inventory/api/agents/v1/ford/en_us/nameplates): Valid model slugs, aliases, body styles, model years, and trims for search requests.

## Browse Pages

- [Inventory Search (SRP)](https://www.ford.com/inventory/): Ford inventory search pages with Car and Offer JSON-LD structured data.
- [F-150 Inventory](https://www.ford.com/inventory/f150/): Live F-150 listings with links to individual vehicle-detail pages.

## Optional

- [Ford Terms of Use](https://www.ford.com/help/terms/): Terms that govern automated read access and the use of inventory results.