---
title: "Get a gear model's Reverb Price Guide detail"
method: GET
path: "/reverb/price-guide"
tags: ["Reverb"]
---

# Get a gear model's Reverb Price Guide detail

`GET /reverb/price-guide`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/reverb/price-guide`
- Auth: API key in header `x-api-key`

Returns one gear model's Reverb Price Guide detail: its specific finish/year variants, monthly average sale-price history, and a page of individual recent sales. slug is the model's slug, from reverb-price-guide-search's own models[].slug field. canonical_product_id optionally scopes to one specific variant from this model's own canonical_products[].id field (from a prior call without it); omitting it aggregates price history and recent sales across every variant, a broader, more heavily-sampled view. condition optionally scopes by Reverb's own Price Guide condition scale (listed below) -- a separate, 6-value enum from reverb-search's own listing condition field. range selects how far back the price history/recent-sales window looks. An unknown slug returns a typed not-found error.

## Query parameters

- `slug` string, required
- `canonical_product_id` string
- `condition` 'mint' | 'excellent' | 'very-good' | 'good' | 'fair' | 'poor'
- `range` 'months_6' | 'years_1' | 'years_2'
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ReverbPriceGuideResponseDoc
  - `code` integer
  - `data` ReverbPriceGuideResponse
    - `brand` string
    - `canonical_product_id` string
    - `canonical_products` ReverbPriceGuideVariant[]
      - `finish` string
      - `id` string
      - `model` string
      - `name` string
      - `year` string
    - `condition` string
    - `fetched_at` string
    - `image_url` string
    - `monthly_prices` ReverbPriceGuideMonthlyPrice[]
      - `average_price` number
      - `currency` string
      - `month` string
      - `sample_size` integer
    - `range` string
    - `recent_sales` ReverbPriceGuideSale[]
      - `condition` string
      - `listing_id` string
      - `price` string
      - `sold_at` string
    - `sales_count` integer
    - `sales_limit` integer
    - `sales_total` integer
    - `slug` string
    - `source_url` string
    - `title` string
    - `url` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[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/0497899e2016?raw)