POST
/
v2
/
market
/
references
/
search
Search market reference aggregates
curl --request POST \
  --url https://api-v2.watchcollect.com/v2/market/references/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "items": [
    {
      "brand": "<string>",
      "reference": "<string>",
      "listing_count": 123,
      "for_sale_count": 123,
      "want_to_buy_count": 123,
      "conditions": [],
      "dial_types": [
        "<string>"
      ],
      "variants": [
        "<string>"
      ],
      "model": "<string>",
      "min_price_eur_minor": 123,
      "max_price_eur_minor": 123,
      "avg_price_eur_minor": 123,
      "median_price_eur_minor": 123,
      "display_min_price": {
        "amount_minor": 123,
        "currency": "<string>"
      },
      "display_max_price": {
        "amount_minor": 123,
        "currency": "<string>"
      },
      "display_avg_price": {
        "amount_minor": 123,
        "currency": "<string>"
      },
      "display_median_price": {
        "amount_minor": 123,
        "currency": "<string>"
      },
      "sample_media_asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "first_seen_at_ms": 123,
      "last_seen_at_ms": 123
    }
  ],
  "has_more": true,
  "total": 123,
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
view_id
string<uuid>

Saved view filters are combined with request filters using AND semantics.

filters
object

Flexible market filter grammar. Documented fields are typed; additional fields are tolerated for forward-compatible frontend experiments and ignored until implemented.

sort
object[]

The current implementation applies the first sort item and falls back to newest listing activity.

page_size
integer
default:50
Required range: 1 <= x <= 200
cursor
string
display_currency
string
Required string length: 3
Example:

"USD"

include
enum<string>[]
Available options:
summary,
facets

Response

Cursor page of reference aggregates.

items
object[]
required
has_more
boolean
required
total
integer<int64>
required
next_cursor
string | null