chewy.com APIchewy.com ↗
Access Chewy.com product search, pricing, promotions, and customer reviews through 3 structured endpoints. Paginated results with schema.org and cursor-based support.
curl -X GET 'https://api.parse.bot/scraper/4b43ad73-b94f-41e6-bc32-d7fe35f180b6/search_products?query=dog+food' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Chewy.com. Returns a CollectionPage structured data object containing an ItemList of products with names, images, prices, ratings, and URLs.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'dog food', 'cat toys'). |
{
"type": "object",
"fields": {
"url": "string, canonical URL for the collection",
"name": "string, category name",
"@type": "string, always 'CollectionPage'",
"@context": "string, schema.org URL",
"mainEntity": "object containing @type 'ItemList' and itemListElement array of products"
},
"sample": {
"data": {
"url": "https://www.chewy.com/b/food-332",
"name": "Food",
"@type": "CollectionPage",
"@context": "https://schema.org",
"mainEntity": {
"@type": "ItemList",
"itemListElement": [
{
"item": {
"url": "https://www.chewy.com/chewy-grain-free-salmon-dog-food/dp/1817862",
"name": "Chewy Made Complete Nutrition High Protein Grain-Free Salmon & Sweet Potato Recipe Dry Dog Food, 24-lb bag",
"@type": "Product",
"image": [
"https://image.chewy.com/catalog/general/images/moe/069f3b12-5b9a-7679-8000-15a8b93256f2._AC_SS100_V1_.jpg"
],
"offers": {
"@type": "Offer",
"price": 59.99,
"availability": "https://schema.org/InStock",
"priceCurrency": "USD"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": 4.4354,
"reviewCount": 5340
}
},
"@type": "ListItem",
"position": 1
}
]
}
},
"status": "success"
}
}About the chewy.com API
The Chewy.com API provides 3 endpoints covering product search, detailed pricing with active promotions, and paginated customer reviews from Chewy.com. The search_products endpoint returns schema.org-structured CollectionPage results including product names, images, prices, and ratings. get_product_details and get_product_reviews let you retrieve per-product pricing data and up to 10 reviews per page with cursor-based pagination.
Product Search
The search_products endpoint accepts a required query parameter (e.g. 'dog food', 'cat toys') and an optional page parameter for pagination. Responses follow the schema.org CollectionPage format, returning a mainEntity object typed as ItemList. Each entry in the itemListElement array includes the product name, image, price, rating, and canonical URL. The name field at the top level reflects the matched category label for the query.
Product Details and Promotions
get_product_details takes a product_id (the product's partNumber, e.g. '119446') and returns a single product record with a base64-encoded id, product name, partNumber, and a pricing object. The pricing object includes the price value, currency, savings information, and any active promotion details. A separate promotions array lists promotion objects associated with the product, each referencing applicable partNumbers and promotion metadata.
Customer Reviews
get_product_reviews returns up to 10 reviews per request for a given product_id. Each item in the edges array contains a node with the review id, numeric rating, text body, title, submittedBy identifier, and submittedAt timestamp, plus a per-edge cursor string. The pageInfo object exposes hasNextPage and endCursor for sequential pagination. totalCount gives the total number of reviews across all pages for the product.
- Aggregate pet product prices from Chewy.com to compare against other retailers using the
pricingresponse field. - Build a promotion tracker that monitors active Chewy deals by polling
get_product_detailsfor thepromotionsarray. - Index Chewy product catalogs by keyword using
search_productswith paginated queries across multiple categories. - Analyze customer sentiment by collecting review
text,rating, andsubmittedAtfields viaget_product_reviews. - Surface top-rated pet products by filtering
search_productsresults by the rating field returned initemListElement. - Automate review ingestion pipelines using cursor-based pagination from
pageInfo.endCursoracross large product catalogs. - Track savings and discount availability for specific products by monitoring the
savingsfields within thepricingobject.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Chewy have an official public developer API?+
What does `get_product_reviews` return and how does pagination work?+
edges array. Every edge includes a node with the review id, rating, text, title, submittedBy, and submittedAt, plus a per-edge cursor. Pass the endCursor string from pageInfo as the cursor input on your next request to retrieve the following page. pageInfo.hasNextPage tells you whether more pages exist, and totalCount reflects the total review count for the product.Does the API return full product specifications, ingredients, or brand information?+
Can I retrieve inventory or stock availability status for a product?+
get_product_details endpoint returns pricing and promotion data but does not expose inventory levels or in-stock status. You can fork the API on Parse and revise it to add a field or endpoint that surfaces stock availability.Is the `search_products` endpoint limited to one category at a time?+
query string per request and returns results scoped to that keyword. Filtering by multiple categories simultaneously or filtering by brand within the request is not currently supported. You can fork the API on Parse and revise it to add category or brand filter parameters.