---
title: "Sold-price comparables"
method: GET
path: "/api/v1/comps"
---

# Sold-price comparables

`GET /api/v1/comps`

## Request

- Base URL: `https://bidprowl.com`
- URL: `https://bidprowl.com/api/v1/comps`
- Auth: HTTP bearer

Category+state aggregates for every key. Item-level percentiles (item=) and per-listing comps with resale margin (listing_id=) require Pro or Pro+.

## Query parameters

- `listing_id` string, uuid
- `item` string
- `category` string
- `state` string

## Response `200`

Comparables

- object
  - `data` SoldStats
    - `median_cents` integer
    - `average_cents` integer
    - `min_cents` integer
    - `max_cents` integer
    - `sold_count` integer
    - `avg_bids` number

## Other responses

- `401`: Missing, invalid or revoked API key.
- `403`: The key is valid but the plan does not include this data.
- `404`: No such listing.
- `429`: Per-minute burst limit or monthly quota exhausted. Read Retry-After, and RateLimit-* to self-throttle before you get here.

---

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