Platitun · API · Catalogue and requests · The usual price for a position

The usual price for a position

GET /api/v1/catalog/usual-price

Key scope: catalog · read only

The median of live listings for a position — a reference so you do not price ten times off the market. One mistaken price skews an average; it does not skew a median. Fewer than three live listings: the answer is “unknown”, not an invented number.

For a real seller, test listings do NOT enter the median: a median of prices nobody buys at is not a reference. For a test key it is the opposite: those are the only listings it has.

Query filters

Field	Type	What it is
`service` required	`string`	The service slug.
`productType` required	`string`	Product type.

Response fields

Field	Type	What it is
`usualPriceRub`	`integer\|null`	The median in roubles. Empty — there is nothing to compare with.

Refusal reasons

A rule refusal arrives as {"error":"rejected","refusal":{"kind":"…"}} with status 409. Refusals common to all endpoints are in the rules section.

Code	What happened and what to do
`bad_request`	The request is malformed: a required field is missing or a value is of the wrong kind. The specifics are in the detail field.

Nearby in this section

GET /api/v1/me — Who am I
GET /api/v1/catalog/services — Search the catalogue
GET /api/v1/catalog/services/{slug} — Everything about a position
GET /api/v1/catalog/demand — Demand: what buyers are waiting for
GET /api/v1/catalog/requests — My catalogue requests
POST /api/v1/catalog/requests — Request a new catalogue position