# Petsmart — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for pet products, browse categories, and get detailed information including reviews all in one place, while also finding nearby PetSmart stores and exploring pet taxonomy to discover products tailored to your pet type. Quickly compare products, read customer feedback, and locate your nearest store to shop for everything your pet needs.

**Category:** E-commerce | **Website:** [petsmart.com/](https://petsmart.com/) | **Docs:** [parse.bot/marketplace/3406a2f6-9580-4d8c-824f-bd7829ae48a7/petsmart-com-api](https://parse.bot/marketplace/3406a2f6-9580-4d8c-824f-bd7829ae48a7/petsmart-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-petsmart-com-api-3406a2f6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_category

Browse products by category hierarchy. Categories use the ' > ' separator and must match PetSmart's internal taxonomy exactly. Returns paginated results sorted by best sellers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Full hierarchical category string using ' > ' separator (e.g. 'Dog > Food > Dry Food', 'Cat > Toys') |
| `limit` | integer | No | Results per page (max 50) |
| `page` | integer | No | Page number (0-indexed) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-petsmart-com-api-3406a2f6/browse_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","limit":"<integer>","page":"<integer>"}'
```

### find_stores

Find PetSmart store locations near a geographic coordinate. Returns stores sorted by distance with details including address, phone, hours, and available services. Coverage varies by region; some areas may return no results within the given radius.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `latitude` | number | Yes | Latitude coordinate of search center |
| `longitude` | number | Yes | Longitude coordinate of search center |
| `radius` | integer | No | Search radius in miles |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-petsmart-com-api-3406a2f6/find_stores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":"<number>","longitude":"<number>","radius":"<integer>"}'
```

### get_pet_taxonomy

Get pet taxonomy data including the complete list of breeds with species, size, and behavioral attributes, plus available color options. No parameters required; returns the full static taxonomy.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-petsmart-com-api-3406a2f6/get_pet_taxonomy \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Get full details for a specific product by its PetSmart product ID. Returns comprehensive product information including pricing, images, descriptions, ratings, and category data. The product ID is available from search or browse results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | PetSmart product ID (e.g. '5252900') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-petsmart-com-api-3406a2f6/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_product_reviews

Get customer reviews for a product via BazaarVoice. Automatically resolves the BazaarVoice product ID from the PetSmart product ID. Returns reviews sorted by helpfulness. Uses offset-based pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max number of reviews to return per request |
| `offset` | integer | No | Offset for pagination (number of reviews to skip) |
| `product_id` | string | Yes | PetSmart product ID (e.g. '5252900') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-petsmart-com-api-3406a2f6/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","product_id":"<string>"}'
```

### search_products

Full-text search across PetSmart's product catalog. Results are sorted by best sellers. Paginates via zero-based page number; each page returns up to `limit` items. The total field reports matching products across all pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page (max 50) |
| `page` | integer | No | Page number (0-indexed) |
| `query` | string | Yes | Search keyword (e.g. 'dog food', 'cat toy') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-petsmart-com-api-3406a2f6/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```