webaz_search
Read-onlyIdempotent
Read-only WebAZ product search and inspection; no auth. Exact-first: use a full title, SKU or precise alias, filters, @anchor, or supported external shopping reference. No match stays empty; do not retry with looser terms or auto-page. Unconstrained browse is capped. result_handle/selected_ids/full_terms and cursor are only for explicit follow-ups. Returns a complete structured product result; never orders or reserves stock.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort: trending=composite (default) / newest / rating / price_asc / price_desc / random | |
| limit | No | Page size; default 5. Unconstrained browse is capped at 8. | |
| query | No | Search keyword (product name or description) | |
| anchor | No | WebAZ @anchor for its exact tagged product | |
| cursor | No | Pagination cursor (from previous next_cursor) | |
| ship_to | No | Ship-to (province/city); auto-filters unshippable | |
| category | No | Category filter (optional) | |
| has_sales | No | true=only sold; false=only new | |
| max_price | No | Max price filter (optional) | |
| seller_id | No | Filter to one seller | |
| full_terms | No | Explicit follow-up: complete public terms for selected products | |
| paste_text | No | Raw external share text or link | |
| recommend_id | No | Legacy display-only highlight; never triggers another search | |
| selected_ids | No | With result_handle: 1..5 product ids chosen FROM that result page. | |
| external_link | No | Structured external shopping reference | |
| result_handle | No | 10-minute prior-result handle; explicit follow-up only | |
| min_return_days | No | Min return days (optional, e.g. 7 = only ≥7-day return) | |
| recommend_reason | No | Legacy display reason (≤140 chars) | |
| max_handling_hours | No | Ships within N hours after payment (optional) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fx | No | display-only USD-base rates ({rates,as_of}) for ≈local hints; never a settlement path | |
| count | No | products returned in this page | |
| error | No | present ONLY on failure (with error_code + structured recovery fields) | |
| sellers | No | deduped seller summaries keyed by seller id (products[].seller_ref) | |
| products | No | ||
| recovery | No | 0 hits: labeled catalog sample + next_step | |
| completion | No | ||
| error_code | No | ||
| next_cursor | No | capability for a user-requested next page; never follow automatically | |
| request_type | No | ||
| response_type | No | authoritative compact result state; consumers must not infer a different state from counts | |
| result_handle | No | 10-minute capability for an explicit user-selected follow-up; never continue automatically | |
| decision_facts | No | deterministic objective comparisons only (price/sales/handling/return); never a subjective recommendation | |
| schema_version | No | ||
| assistant_action | No | ||
| selection_required | No | deprecated v1.0 compatibility field; false because v1.1 does not require an automatic selection/follow-up | |
| orchestration_version | No | deterministic WebAZ decision-plan version | |
| detail_required_for_card | No | deprecated v1.0 compatibility field; false because ordinary results are already display-ready |