---
title: "List a Chewy category or search's refinement options"
method: GET
path: "/chewy/facets"
tags: ["Chewy"]
---

# List a Chewy category or search's refinement options

`GET /chewy/facets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/chewy/facets`
- Auth: API key in header `x-api-key`

Returns 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. No products are returned, so this 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 the requested listing: each brand option carries its product count and, where Chewy publishes one, its own chewy.com/brands/<slug>-<id> 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 this endpoint, chewy_category, and chewy_search alike; passing filter here narrows the listing first, so the returned counts describe the already-narrowed result set. A group_id Chewy does not recognize returns a 404 rather than an empty option set.

## Query parameters

- `group_id` string
- `q` string
- `filter` string[]

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ChewyFacetsResponseDoc
  - `code` integer
  - `data` ChewyFacetsResponse
    - `count` integer
    - `facets` ChewyFacet[]
      - `count` integer
      - `name` string
      - `options` ChewyFacetOption[]
        - `display_label` string
        - `id` string
        - `name` string
        - `product_count` integer
        - `seo_hvf_slug` string
        - `url_slug` string
        - `value` string
      - `value` string
    - `fetched_at` string
    - `group_id` string
    - `query` string
    - `source_url` string
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)