Search catalog products
Search the product catalog for a given country. Filter deterministically by product type, brand, zero-touch deployment support, stock availability, and by specification via specifications. ram, storage (GB amounts), screenSize (whole inches), processor (BRAND|Family) and keyboardLayout (layout code) are canonical: pass the values the catalog filter-options endpoint returns for them, verbatim, and a value matches every product whose stored specification maps to it (16 GB or Intel Core Ultra 7 match nothing). operatingSystem, resolution, position, color and the other keys are matched as case-insensitive prefixes of free text the suppliers spell inconsistently, so take those values from filter-options too. There is no numeric comparison — express “at least 16 GB” by listing every option at or above it. search only matches the product name — never put specifications in it. total is the full match count: page through it with page/take (take max 100) to see every match. Variants and stock are not included: read them with getCatalogProducts, up to 20 product ids per call.
Authorizations
Use your Primo API key in the Authorization header as Bearer <API_KEY>.
Path Parameters
Body
Substring match on the product NAME only (case-insensitive, not tokenized). Use it for a model name such as "ThinkPad" or "MacBook Air" — never for specifications, which it does not read: "16 GB business laptop" matches nothing.
Filter by product types (e.g. laptop, monitor)
laptop, tablet, smartphone, cable_adapter, charger, headset, hub, keyboard, laptop_case, monitor, mouse, other Filter by brand names
Only return products that support zero-touch deployment
Only return products with at least one supplier holding stock in the requested country
Filter on the product specifications, keyed by specification name. ram, storage (GB amounts), screenSize (whole inches) and processor (BRAND|Family) are canonical: pass the exact values the catalog filter-options endpoint returns for them, a value matches every product whose stored specification maps to it. operatingSystem, resolution, position, color and the other keys are matched as a case-insensitive PREFIX of the stored free-text specification. keyboardLayout takes the layout codes the filter-options endpoint returns and matches products with a variant (or a product-level layout) sold in the country, in stock when hasStock is set. Values inside one key are OR-ed, different keys are AND-ed: {"ram":["16","32"],"operatingSystem":["Windows 11 Pro"]} returns 16 GB or 32 GB machines running Windows 11 Pro. There is no numeric comparison — express "at least 16 GB" by listing every option at or above 16.
x <= 9007199254740991x <= 100