# Chewy Search

## Overview

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

## Description

Scrape Chewy search, brand, or category pages to retrieve a list of products with pricing, 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search Feliway brand page

```json
{
  "results": [
    {
      "ppu": "$24.99/ea",
      "href": "https://www.chewy.com/feliway-multicat-30-day-starter-kit/dp/116881",
      "name": "Feliway MultiCat 30 Day Starter Kit Calming Diffuser for Cats, 1 count",
      "image": "https://image.chewy.com/catalog/general/images/feliway-multicat-30-day-starter-kit-calming-diffuser-for-cats-1-count/img-740068,1",
      "is_ad": false,
      "is_atf": false,
      "is_new": false,
      "rating": 3.711,
      "is_deal": true,
      "in_stock": true,
      "is_fresh": false,
      "is_bundle": false,
      "is_frozen": false,
      "description": "After cats give birth, they naturally produce pheromones that send harmony messages to their little ones. Feliway MultiCat 30 Day Starter Kit mimics these natural pheromones to restore harmony between felines.",
      "part_number": "94199",
      "manufacturer": "Feliway",
      "rating_count": 3246,
      "strike_price": "$33.99",
      "display_price": "$24.99",
      "autoship_price": "$23.74",
      "is_rx_vet_diet": false,
      "is_discontinued": false,
      "is_prescription": false
    },
    {
      "ppu": "$24.99/ea",
      "href": "https://www.chewy.com/feliway-multicat-calming-diffuser-refill/dp/52450",
      "name": "Feliway MultiCat Calming Diffuser Refill for Cats, 1 count",
      "image": "https://image.chewy.com/catalog/general/images/feliway-multicat-calming-diffuser-refill-for-cats-1-count/img-627449,1",
      "is_ad": false,
      "is_atf": false,
      "is_new": false,
      "rating": 3.914,
      "is_deal": false,
      "in_stock": true,
      "is_fresh": false,
      "is_bundle": false,
      "is_frozen": false,
      "description": "Help create harmony and avoid conflict between your cats with Feliway MultiCat Calming Diffuser Refill.",
      "part_number": "52450",
      "manufacturer": "Feliway",
      "rating_count": 1842,
      "strike_price": null,
      "display_price": "$24.99",
      "autoship_price": "$23.74",
      "is_rx_vet_diet": false,
      "is_discontinued": false,
      "is_prescription": false
    }
  ]
}
```

## Documentation

## Overview
The Chewy Search API scrapes any Chewy search result, brand, or category listing page and returns a structured list of products with pricing, ratings, and availability.

## Quickstart
```
GET https://api.piloterr.com/v2/chewy/search?query=https://www.chewy.com/brands/feliway-6614
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Chewy search, brand, or category URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results[].name` | string | Product name |
| `results[].href` | string | Product page URL |
| `results[].display_price` | string | Current displayed price |
| `results[].autoship_price` | string | Autoship subscription price |
| `results[].rating` | number | Average star rating |
| `results[].in_stock` | boolean | Stock availability |
| `results[].is_deal` | boolean | Whether the item is on sale |
| `results[].manufacturer` | string | Brand/manufacturer name |

## Notes
- Supports search, brand, and category pages.
- Results reflect the first page of the URL.

## Main use cases
- Scrape Chewy brand pages to build comprehensive product catalogs for pet brands
- Monitor price changes and deal flags across Chewy search results for retail intelligence
- Aggregate competitor product listings for market research in the pet industry
- Feed product discovery pipelines for pet supply comparison tools and marketplaces