Search products
oskelly_search_productsRead-onlyIdempotent
Search the oskelly.ru luxury catalog by text query or filters (brand, category, size, price, sale) and get matching product cards with price, condition, sizes, and seller details.
Instructions
Search the oskelly.ru luxury marketplace catalog and return matching product cards (id, brand, category, price, discount, condition, in-stock sizes, seller, image, URL). Supports full-text query, faceted filtering (brand, category, size, condition, collection, model, seller type, boutique, price range, boolean tags such as sale/vintage/outlet), pagination and sorting. Use oskelly_search_facets first when you need to know which filter values are available, and oskelly_filter_values to resolve names to ids.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. | |
| price | No | Price range in RUB; at least one of lower/upper must be set. NOTE (verified live): the backend matches this per size/SKU, not against the card price. A product matches if ANY of its sizes is priced inside the range, and the returned card `price` is the cheapest size — so a card price may fall outside the requested range. Compare against `sizePriceRange` on each result to see the actual span. | |
| query | No | Full-text query, e.g. "gucci сумка". Omit to browse the catalog without a text query. | |
| sizeIds | No | Size value ids (from oskelly_filter_values code='size'). | |
| sorting | No | NEW = newest first, PRICE_ASC / PRICE_DESC = by price, SCORE_DESC = by relevance (only meaningful with a query), PERSONALIZED = site's own ranking. | NEW |
| verbose | No | Return the raw upstream payload instead of the compact projection. Much larger. | |
| brandIds | No | Brand ids (from oskelly_list_brands or oskelly_filter_values code='brand'). | |
| modelIds | No | Model ids (from oskelly_filter_values code='model'). | |
| sellerIds | No | Restrict results to specific seller account ids. | |
| pageLength | No | Items per page (1-60). Keep small to limit response size. | |
| categoryIds | No | Leaf/branch category node ids (from oskelly_category_tree). | |
| baseCategory | No | Root segment node id from the category tree: 2 = Женское, 105 = Мужское, 188 = Детское, 366 = Лайфстайл. These are real tree node ids — read them from oskelly_category_tree rather than assuming. Omit to search all segments. | |
| conditionIds | No | Condition ids: 1 = Новое с биркой, 2 = Отличное, 3 = Хорошее. | |
| extraFilters | No | Escape hatch: raw filter entries merged into the request body verbatim, for facet codes discovered via oskelly_search_facets that this schema does not name yet. | |
| collectionIds | No | Collection ids: 5 = Новая коллекция, 6 = Sale, 7 = Аутлет. | |
| sellerTypeIds | No | Seller type ids (from oskelly_filter_values code='sellerType'). | |
| booleanFilters | No | Boolean facet toggles, e.g. {"sale": true, "vintage": true}. Available codes: sale, oskellyChoice, streetwear, newCollection, inStock, outlet, carry_over, celebrity_wardrobe, investment, vintage, brandNew, resale, exclusiveSelection, currentCollection | |
| boutiqueLocationTagIds | No | OSKELLY boutique location ids (from oskelly_filter_values code='boutiqueLocationTag'). |