---
title: "Get a vehicle listing's price history"
method: GET
path: "/datasets/vehicle-listings/price-history/{id}"
tags: ["Datasets"]
---

# Get a vehicle listing's price history

`GET /datasets/vehicle-listings/price-history/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/vehicle-listings/price-history/{id}`
- Auth: API key in header `x-api-key`

Returns the recorded price-change events for one listing, oldest first. An event is recorded only when a crawl first observes the listing or observes a changed price -- not one entry per crawl pass -- so a listing whose price has never changed since it was first crawled returns a single entry.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsVehicleListingPriceHistoryResponseDoc
  - `code` integer
  - `data` DatasetsVehicleListingPriceHistoryResponse
    - `id` string
    - `items` EsVehiclePriceHistoryRecord[]
      - `crawled_at` string
      - `id` string
      - `price` number
      - `schema_version` integer
      - `snapshot_date` string: SnapshotDate is the crawl date (YYYY-MM-DD) this price was observed on -- part of the doc id, so re-crawling the same listing twice in one day at a changed price overwrites that day's entry rather than creating a second one for the same date.
      - `source` string
      - `source_listing_id` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)