Get result count and available facets
oskelly_search_facetsRead-onlyIdempotent
Run a search to get total matches and available facets, revealing which filters to apply and result volume before fetching products.
Instructions
Run the same search as oskelly_search_products but return the total result count plus the list of facets available for that result set (their codes, names, types, hot values and the price range present) instead of the products. Use this to discover which filters make sense before drilling down, or to count matches cheaply without fetching items.
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'). |