# Chewy Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/chewy/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/chewy-product |

## Description

Retrieve full product details from a Chewy product page URL, including pricing, variants, ratings, and availability.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/chewy/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by product URL (Pee Pads)

```json
{
  "ROOT_QUERY": {
    "pdp": {
      "__typename": "PDP",
      "featureToggles": {
        "__typename": "PDPFeatureToggles",
        "qnaEnabled": true,
        "reviewsEnabled": true,
        "fbtWidgetEnabled": true,
        "realTimeDealsEnabled": true,
        "loyaltyFeaturesEnabled": true
      }
    },
    "__typename": "Query",
    "currentUser": null,
    "item({\"id\":\"371150\"})": {
      "__ref": "Item:SXRlbTozNzExNTA="
    },
    "product({\"id\":\"371138\"})": {
      "__ref": "Product:UHJvZHVjdDozNzExMzg="
    }
  },
  "Item:SXRlbTozNzExNTA=": {
    "id": "SXRlbTozNzExNTA=",
    "gtin": "672288001200",
    "name": "Green Lifestyle Printed Reusable Cat & Dog Pee Pads, Blue & White, 41 x 41-in, 2 count",
    "entryID": "371150",
    "inStock": true,
    "isFresh": false,
    "isBundle": false,
    "isFrozen": false,
    "mapPrice": "$34.99",
    "isInStock": true,
    "isVetDiet": false,
    "onSpecial": true,
    "__typename": "Item",
    "dimensions": "41 x 41 x 0.3 inches",
    "isGiftCard": false,
    "isLiveFeed": false,
    "partNumber": "344914",
    "description": "Protect your home from a variety of pet messes with Green Lifestyle Printed Reusable Pee Pads for Cat & Dog.",
    "isPublished": true,
    "keyBenefits": [
      "Large, thick pads are ideal for a variety of pets, including pups, feline friends and bunnies.",
      "Waterproof backing locks in moisture to prevent messy leaks.",
      "Reusable, fabric pads feature reinforced seams.",
      "Terrific for puppies who are potty training and senior sidekicks with medical issues."
    ],
    "perUnitPrice": "$17.50",
    "autoshipPrice": "$33.24",
    "isUnavailable": false,
    "isPrescription": false,
    "advertisedPrice": "$34.99",
    "shippingMessage": "**FREE 1-3 day delivery** on first-time orders over $35",
    "autoshipDiscountPct": "5",
    "unitOfMeasureString": "ea"
  },
  "Product:UHJvZHVjdDozNzExMzg=": {
    "id": "UHJvZHVjdDozNzExMzg=",
    "name": "Green Lifestyle Printed Reusable Cat & Dog Pee Pads, Blue & White",
    "slug": "green-lifestyle-printed-reusable-cat",
    "rating": 4.6938,
    "entryID": "371138",
    "__typename": "Product",
    "isEnsemble": false,
    "partNumber": "344902",
    "description": "Protect your home from a variety of pet messes with Green Lifestyle Printed Reusable Pee Pads for Cat & Dog.",
    "ratingCount": 369,
    "manufacturerName": "Green Lifestyle"
  }
}
```

## Documentation

## Overview
The Chewy Product API retrieves structured product data from any Chewy product page. Given a product URL, it returns the full product graph including item variants, pricing, autoship discounts, stock status, images, ratings, reviews, key benefits, and more.

## Quickstart
```
GET https://api.piloterr.com/v2/chewy/product?query=https://www.chewy.com/dp/371150
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Chewy product URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `Item.name` | string | Full product name including size/count |
| `Item.advertisedPrice` | string | Displayed retail price |
| `Item.autoshipPrice` | string | Autoship subscription price |
| `Item.inStock` | boolean | Whether the item is in stock |
| `Product.rating` | number | Average star rating |
| `Product.ratingCount` | number | Total number of ratings |
| `Product.manufacturerName` | string | Brand/manufacturer name |

## Notes
- The response is a normalized GraphQL cache object with variant-level Item keys.
- Autoship pricing is included when available.

## Main use cases
- Monitor competitor pet product pricing on Chewy for dynamic repricing strategies
- Build a product catalog enriched with real-time Chewy stock and rating data
- Automate price tracking across thousands of Chewy SKUs for retail intelligence
- Enrich pet product databases with descriptions, images, and key benefits from Chewy