# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/petsmart/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/petsmart/browse-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/petsmart/find-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/petsmart/get-pet-taxonomy \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/petsmart/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/petsmart/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/petsmart/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.