chewy_facets
The full set of refinement options (facets) a Chewy category or keyword search can be narrowed by -- brand, sub-category, lifestage, food form, breed size, special diet, health feature, flavor, ingredient, packaging type, price band, customer rating, and whichever other dimensions that listing exposes -- with each option's product count. Returns no products, so it is a much smaller call than chewy_category/chewy_search when only the option set is wanted. The Brand dimension is effectively Chewy's brand directory for that listing: each brand option carries its product count and, where Chewy publishes one, its own chewy.com/brands/- landing-page slug in seo_hvf_slug. Exactly one of group_id or q is required. Every facets[].value paired with one of that facet's options[].value is a ready-to-use filter key:value pair for chewy_facets, chewy_category, and chewy_search alike; passing filter here narrows the listing first, so the returned counts describe the already-narrowed result set.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "chewy_facets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Optional. Free-text search keywords to return the refinement options for, e.g. "salmon dog food". Exactly one of group_id or q is required. | |
| filter | No | Optional, repeatable, up to 10. Each value is "key:value" -- a facets[].value paired with one of that facet's options[].value, e.g. "brand_facet:ACANA". Narrows the listing first, so the returned option counts describe the already-narrowed result set. | |
| group_id | No | Optional. Chewy's own numeric category id -- the trailing id segment of a chewy.com/b/<slug>-<id> browse URL, e.g. 294 for /b/dry-food-294. Exactly one of group_id or q is required. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool result payload (shape varies per tool; see each tool's docs resource). |