POST
Search live cheap-listing feed

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. Use this for market scopes such as EU.

filters
object

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

min_discount_percent
number<double>
default:5

Minimum percent below the median comp price required for a listing to appear.

Required range: 0 <= x <= 100
sort
enum<string>
default:best_discount
Available options:
best_discount,
newest
page_size
integer
default:50
Required range: 1 <= x <= 200
cursor
string | null

Base64url cursor with created_at_ms and listing id. Omit on first live stream connection to start at server now.

display_currency
string
Required string length: 3
Example:

"EUR"

Response

Cheap live listing feed for the effective filter.

items
object[]
required
comparable_count
integer
required

Number of for-sale comp listings in the effective filter set.

matching_count
integer
required

Total matching cheap listings before page size truncation.

min_discount_percent
number<double>
required
updated_at_ms
integer<int64>
required
median_price_eur_minor
integer<int64> | null
effective_filter
object

Server-normalized effective filter envelope returned for debugging saved-view and request filter composition.