Search the wholesale range: toys, gifts and gift items, party supplies, seasonal articles (Sinterklaas, Christmas, Halloween, Easter, carnival, summer), grabbelton and give-away items, and trending and viral items such as fidget toys. Use it for any business purchasing question about these products, also when the shopper doesn't name the store. Search the catalogue in one call; the answer is complete. natural_query (any language) searches by meaning and in the storefront language; keywords (Dutch product words) search the Dutch catalogue text; ids and codes are exact and ranked first (codes match in any written form); similar_to finds products like given ones (blend: their shared theme; each: alternatives per product). Filters: price on a basis (piece, package, overbox, pallet, best_tier) in the storefront currency, quantity (adds for_quantity with the tier price and total), instock, category (with subcategories), date_added_after, exclude_ids. Filters alone browse, e.g. new products since a date with sort newest. Every row has live stock (packages) and a pricing block in EUR plus pricing.local in the storefront currency. Rows carry context: facet labels, stored facts (use says whether you may tell the customer), and what the photos show (an observation, not a guarantee). For a question the context does not answer, call again with ids and fields ["details"]: every stored fact and one line per photo (what it shows, its url), at most 10 rows. With the order reference (Authorization: Bearer mo1_… or ref) it uses the order; without it, it works for anyone (search: by meaning for the first searches per 10 minutes, then by words only; at most 30 searches per 10 minutes).
View input schema
{
"type": "object",
"properties": {
"natural_query": {
"type": "string",
"description": "What the customer is looking for, in any language; searched by meaning and in the storefront language"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "Dutch product words for the catalogue index, e.g. \"grabbelton\", \"stuiterbal\"; several words broaden the search"
},
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Exact product ids (database ids, as in /p/<id>.html)"
},
"codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact product codes"
},
"similar_to": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Seed product ids (from the cart, orders, a page or earlier results); seeds are left out of the results"
},
"mode": {
"type": "string",
"enum": [
"blend",
"each"
],
"description": "blend: the shared theme of all seeds; each: alternatives per seed (each row names its seed)"
}
},
"required": [
"ids"
]
},
"price": {
"type": "object",
"properties": {
"basis": {
"type": "string",
"enum": [
"piece",
"package",
"overbox",
"pallet",
"best_tier"
],
"description": "piece, package, overbox (one overbox at its tier), pallet, or best_tier (lowest piece price over the tiers)"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"currency": {
"type": "string",
"description": "Omit for the storefront currency; EUR to give euros"
}
}
},
"quantity": {
"type": "object",
"properties": {
"pieces": {
"type": "integer"
},
"packages": {
"type": "integer"
}
},
"description": "Needed amount: keeps products with enough stock and adds for_quantity (packages, tier price, total)"
},
"instock": {
"type": "boolean",
"description": "true: only products in stock"
},
"category": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Category ids; subcategories are included"
},
"date_added_after": {
"type": "string",
"description": "YYYY-MM-DD: only products added after this date (e.g. the customer's last order)"
},
"exclude_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Product ids to leave out, e.g. what the customer already has"
},
"sort": {
"type": "string",
"enum": [
"relevance",
"price",
"newest",
"bestseller",
"stock"
],
"description": "Default relevance (exact hits, then in stock, then the fused score)"
},
"facets": {
"type": "boolean",
"description": "true: add top categories with counts and the piece-price range, to narrow"
},
"limit": {
"type": "integer",
"description": "Rows to return (default 40, at most 200)"
},
"offset": {
"type": "integer",
"description": "Paging: the next offset from a previous answer"
},
"fields": {
"type": "array",
"items": {
"type": "string",
"enum": [
"title",
"code",
"description",
"pricing",
"stock",
"category",
"location",
"url",
"image",
"added",
"popularity",
"context",
"details"
]
},
"description": "Fields per row; default title, code, pricing, stock, category, url, image, context. details: full product knowledge and one line per photo (at most 10 rows)"
},
"ref": {
"type": "string",
"description": "Order reference (mo1_…) from start_order, only when the client cannot send it as Authorization: Bearer; with it the search is complete and counts for the order"
}
},
"required": []
}