---
title: "Market Listings API"
method: GET
path: "/v1/listings"
tags: ["Market Data"]
---

# Market Listings API

`GET /v1/listings`

## Request

- Base URL: `https://marketlistings.vinaudit.com`
- URL: `https://marketlistings.vinaudit.com/v1/listings`
- Auth: API key in query parameter `key`
- TypeScript: <https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/docs/v1/listings/get.ts> (a function with typed inputs; its response is checked against the schema)

Search retail vehicle listings across the US and Canada with 20+ filters (dealer, location, radius, year/make/model/trim, vehicle attributes). Also accepts POST with the same parameters.

## Query parameters

- `format` 'json' | 'xml'
- `vin` string
- `vehicle_make` string
- `spec_vin` string
- `spec_vin_match` 'model' | 'trim'
- `spec_id` string
- `listing_type` string
- `listing_price_min` number
- `listing_price_max` number
- `postal` string
- `latitude` number
- `longitude` number
- `radius` integer
- `city` string
- `region` string
- `country` 'usa' | 'canada'
- `seller_type` 'franchise' | 'independent' | 'private'
- `seller_id` string
- `dealer_attribution` integer
- `spec_accuracy` integer
- `listing_status` string
- `history_days` integer
- `vehicle_type` 'sedan' | 'coupe' | 'truck' | 'suv' | 'hatchback' | 'van' | 'wagon' | 'convertible' | 'minivan'
- `vehicle_fuel_type` 'diesel' | 'electric' | 'flex' | 'gasoline' | 'hybrid' | 'hydrogen' | 'plug-in'
- `vehicle_engine_cylinders` integer
- `vehicle_transmission_type` 'automatic' | 'manual'
- `vehicle_drivetrain` 'rwd' | 'fwd' | 'awd' | '4wd'
- `vehicle_doors` integer
- `page_size` integer
- `page` integer

## Response `200`

Paged list of listings

- object
  - `total` integer: Listings in this page
  - `query_total` integer: Total matching listings
  - `page` integer
  - `page_size` integer
  - `listings` object[]

---

[API](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis.md) - [All operations](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/vinaudit/apis/vinaudit-data-apis/revisions/1f1500e74b46?raw)