---
title: "Month-by-month median sale price for an item"
method: GET
path: "/comps/trend"
---

# Month-by-month median sale price for an item

`GET /comps/trend`

## Request

- Base URL: `https://govauctions.app/api/v1`
- URL: `https://govauctions.app/api/v1/comps/trend`
- Auth: HTTP bearer

Sold-price trend built from the same matched comps as /comps, so the two can never disagree. Months with too few sales are dropped; a query without enough qualifying months returns an empty `data` array with a reason rather than a misleading two-point line.

## Query parameters

- `q` string, required
- `category` string
- `country` 'US' | 'UK' | 'CA' | 'AU' | 'DE' | 'FR'
- `state` string

## Response `200`

Monthly medians plus a first-to-last change percentage

## Other responses

- `403`: Not in plan
- `429`: Monthly valuation allowance exhausted

---

[API](https://skmtc.dev/govauctions/apis/govauctions-data-api.md) · [All operations](https://skmtc.dev/govauctions/apis/govauctions-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govauctions/apis/govauctions-data-api/revisions/7e81b5468d24?raw)