Search products
search_productsSearches the product catalog of a Japanese music-production buying guide by typed, non-personal vocabulary: category, brand (slug or id), product_id, alias (an exact product name or registered alias, matched after normalization), plugin format, OS and license, or by a free-text product name (q). Returns products with ids, editions, brand, category, product type tokens (roles, e.g. eq, compressor, reverb, synth; absent when unknown), catalog status and checked_at; an unresolved alias returns 0 products with unresolved_constraints=[alias_unresolved]. Current offers of a product are returned by get_current_offers. Optional q (up to 200 characters) is a product name as typed: any spelling, katakana, hiragana or romaji; shopping words such as セール, 最安, sale or upgrade are ignored. A maker name at the start or end is set aside and the rest is matched against that maker's products only (Sennheiser e 935 matches e935 exactly); a model of another maker or an unlisted model gives 0 products. It is matched like the site's own search (exact, prefix, substring, several words, then similar spellings that begin like the query, carry the same numbers and, for several words, cover the last word); a product type or category word (reverb, リバーブ, コンプ, ヘッドフォン) answers with up to 20 products of that type. Typed filters narrow q before the cut to 20. At most 20 products, in match order; matched_alias is the registered spelling that matched and match_kind how (exact, prefix, substring, tokens, fuzzy, role, category); with a maker name, fuzzy only covers a typing error in a listed product name (a word with digits, such as a model number, has to match exactly), and without one it can be a sibling model. No match: 0 products with unresolved_constraints=[q_unresolved]. More than 20 matches: limits_hit=[result_limit] and search_complete=false, and next_cursor pages only within the 20. alias takes precedence over q; a q cursor is valid only for the same q and filters. q is used only to compute the answer; the text itself is not stored or logged. A product the site has measured itself also carries measurements (newest first) in summary form: evidence_id, edition_id, product_version, measured_at, results as named fields each with { value, decimals } (the decimals it was read with, e.g. export_duration_seconds, latency_compensation_samples, integrated_loudness_lufs, true_peak_dbtp), runs, result_statistic and disclosure (provided, loaned or self_purchased). The full record (environment, settings, comparison conditions, procedure, failure cases) is returned by compare_products. They are not a sound-quality rating; the key is absent when there is no measurement. A call with no filter (no q, alias, category, brand, product_id, format, os or license) and no cursor also carries, at the top level, measurements: the site's synthetic demonstrations (record_kind synthetic_demonstration), signal-processing facts shown with signals the site generated, concerning no product, in full: subject_ja, results ({ value, decimals }, e.g. null_residual_peak_dbfs, thd_percent, aliasing_max_dbfs, rt60_seconds), and how to run them again (script_ref path and commit, signal_seed, libraries, artifacts with sha256). canonical_page is the product page on this site; it carries the complete price table (including listings withheld on this channel), the merchant purchase links and the affiliate disclosure. site_entry_page is the same page with the entry marker for this channel. Read-only. Links are user_navigation handoffs (handoff_mode=user_navigation) and are not intended for prefetching or automatic clicking.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | A product name as typed (1 to 200 characters), optionally with its maker: any spelling, katakana, hiragana or romaji. A maker name at the start or end (its name, slug, alias or katakana reading, also in the form e935 by Sennheiser or with a possessive) is set aside and the rest is matched against that maker's products only; a model of another maker, or one the catalogue does not list, matches nothing. Shopping words (セール, 最安, sale, upgrade, full version and similar) and a trailing product-type phrase (dynamic microphone and similar, whatever the product's type) are set aside, unless that would leave only a maker name or a type word, and a query of shopping words only matches nothing. Matched like the site's own search: exact, prefix (which can return a longer name of the same series, such as UR44C for UR44), substring, every word of several words, then similar spellings that begin like the query, carry the same numbers and, for several words, cover the last word; with a maker name, a similar spelling only covers a typing error in a listed product name: the same numbers, and a word that differs by one letter (two when both words have eight or more letters); a word with digits, such as a model number, or a three-letter word has to match exactly. A product type or category word (reverb, リバーブ, コンプ, ヘッドフォン), alone or after a maker name, and a maker name with a type phrase (studio headphones, dynamic EQ), answer with up to 20 products of that type; descriptive words such as dynamic or condenser are not checked against the data. It travels only in a request body, never in a URL, and is used only to compute the answer; the text itself is not stored or logged. | |
| os | No | ||
| alias | No | ||
| brand | No | ||
| limit | No | ||
| cursor | No | ||
| format | No | ||
| license | No | ||
| category | No | ||
| product_id | No |