Search products
search_productsRead-only
Search the SoundCreation catalog by free text (brand, model, category, or keywords), by filters, or both. With a query you get relevance-ranked results; with filters only you get a sorted browse ("cheapest in-stock electric guitar under 2000"). All prices include VAT and are locale-correct. A record with sale_quantity can be bought only in that quantity (for example speakers sold only in pairs): its price is per piece - quote price_for_minimum_quantity and state the rule (sale_quantity.note). sale_quantity.quantity_prices, when present, lists cheaper prices per piece from a quantity (from_quantity, price_per_piece, percent_off).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Default: relevance with a query, cheapest-first without one. | |
| brand | No | Restrict by brand name, partial match. | |
| limit | No | Max results (default 20). | |
| query | No | Free-text search query. Optional if you supply at least one filter. | |
| offset | No | Skip this many results, for paging through a filtered list. | |
| category | No | Restrict by category name, partial match (use when you do not know the id). | |
| in_stock | No | true = only items physically in stock and shippable now. | |
| language | No | Locale for text + pricing (ro=RON, hu=HUF, de/en=EUR). Default ro. | |
| on_promo | No | true = only items currently discounted (price_old is the pre-discount price). | |
| condition | No | new (default) = normal catalog items. open_box = individually priced used/opened units; each result is one physical unit. bundle = pre-priced sets of several products sold together for less. | |
| max_price | No | Highest acceptable price, in the response currency for the chosen language. | |
| min_price | No | Lowest acceptable price, in the response currency for the chosen language. | |
| category_id | No | Restrict to one category id. Ids come back on every result. |