Browse a Chewy category listing API

Endpoint facts

Method

GET

API path

/chewy/category

Auth

apiKey

Credits

3 credits/request

Platform

Chewy

Response schema

#/definitions/chewy.categoryResponseDoc

Overview

Returns one page (36 products) of a Chewy category/browse listing's product grid (price, autoship price/discount, stock, rating, images), plus embedded facets and breadcrumbs. group_id is 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. Every breadcrumbs[].group_id and facets[].options[].value in a response is a ready-to-use group_id for a follow-up call, so a caller can discover the full category taxonomy starting from a known category. A group_id Chewy does not recognize returns a 404 rather than an unfiltered listing. sort and filter narrow/reorder the listing; every facets[].value paired with one of that facet's options[].value from any prior response is a valid filter key:value pair (e.g. brand, breed size, flavor, price range, customer rating -- whichever facets that category exposes). Developers commonly use this endpoint for data enrichment, monitoring, research dashboards, internal automation, and agent-native workflows that need repeatable structured public web data. Authentication uses the documented Crawlora headers, and usage is metered with the credit cost shown on this page.

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost

3 credits/request

Charged response

Successful 2xx responses

Infrastructure behavior

This endpoint is executed through Crawlora's managed scraping infrastructure.

• Proxy strategy: managed automatically where needed
• Browser rendering: enabled for supported targets that require rendered HTML or JavaScript execution
• Browser cluster: supported dynamic workloads can be routed through distributed browser instances
• Retry behavior: automatic retry/fallback may be used depending on endpoint type
• Challenge handling: challenged pages or unusable upstream HTML are detected and surfaced clearly when they cannot be used
• Billing: credits are charged only for successful 2xx responses
• Observability: responses include request context where available

Response behavior

- Pagination is 36 products per page via `page` (1-based, defaults to 1). `total` is the category's total result count across all pages (after any `filter` is applied). - Every `breadcrumbs[].group_id` and `facets[].options[].value` in a response is a ready-to-use `group_id` for a follow-up call -- this is how a caller discovers the full category taxonomy, starting from a known category and following its breadcrumbs/facets. - A `group_id` Chewy does not recognize at all returns a `404` rather than an unfiltered listing. - `autoship_price`/`autoship_discount_pct` reflect Chewy's Autoship subscribe-and-save program; both are omitted when the product isn't Autoship-eligible. - `strike_price` is present only when the product has a struck-through list price above its current price. Example response: ```json {"code":200,"msg":"OK","data":{"group_id":"294","name":"Dry Food","page":1,"page_size":36,"total":2185,"count":1,"products":[{"part_number":"4238414","parent_part_number":"4238390","name":"Nutri-Choice Advantage Salmon & Pea Dry Dog Food, 3.5-lb bag","manufacturer":"Nutri-Choice Advantage","url":"https://www.chewy.com/nutri-choice-advantage-salmon-pea-dry/dp/4238414","image_url":"https://image.chewy.com/catalog/general/images/moe/06a16c4a.jpg","currency_code":"USD","price":8.99,"autoship_price":8.54,"autoship_discount_pct":"5%","is_autoship_allowed":true,"in_stock":true,"is_new":true,"has_more_choices":true,"rating":4.6,"rating_count":12},"facets":[{"name":"Category","value":"categoryId","options":[{"name":"Adult","display_label":"Adult Dry Dog Food","value":"11098","url_slug":"adult-dry-dog-food","product_count":64}]}],"breadcrumbs":[{"group_id":"288","url_slug":"dog","text":"Dog Supplies"},{"group_id":"332","url_slug":"food","text":"Dog Food"}],"source_url":"https://www.chewy.com/plp/api/search?catalogId=1004&groupId=294&count=36&from=0","fetched_at":"2026-08-20T10:00:00Z"}}} ```

Error behavior

Crawlora does not silently return bad data when the upstream page cannot be used.

When possible, Crawlora returns structured error context so your integration can retry, back off, or inspect the request.

Related