petsmart.com APIpetsmart.com ↗
Access PetSmart product search, category browsing, product details, customer reviews, store locations, and pet breed taxonomy via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/db75a47a-d919-4bb9-8d23-6cb0ddceefd9/search_products?limit=3&query=cat+toy' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for pet products by keyword. Returns paginated results from PetSmart's product catalog sorted by best sellers.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| limit | integer | Results per page |
| queryrequired | string | Search keyword (e.g. 'dog food', 'cat toy') |
{
"type": "object",
"fields": {
"total": "integer total number of matching products",
"products": "array of product objects with id, name, brand, price, images, bvAverageRating, bvReviewCount, custom_category_names, and more"
},
"sample": {
"data": {
"total": 2523,
"products": [
{
"id": 5354678,
"name": "WOOF Pupsicle Refill Pops: Peanut Butter and Chicken Recipe",
"brand": "Woof",
"price": {
"number": 14.99,
"formatted": {
"primary": "$14.99-$17.99"
},
"displayType": "range"
},
"images": {
"large": "https://s7d2.scene7.com/is/image/PetSmart/5354678?$sclp-prd-main_large$",
"small": "https://s7d2.scene7.com/is/image/PetSmart/5354678?$sclp-prd-main_small$"
},
"bvReviewCount": 5674,
"bvAverageRating": 4.7,
"masterProductID": 83704,
"custom_category_names": [
"Dog",
"Dog > Toys",
"Dog > Toys > Interactive Toys"
]
}
]
},
"status": "success"
}
}About the petsmart.com API
The PetSmart API covers 6 endpoints that expose product catalog data, customer reviews, store locations, and pet breed taxonomy from petsmart.com. Use search_products to query the full catalog by keyword, browse_category to navigate PetSmart's hierarchical category tree, or find_stores to retrieve nearby store locations with address, hours, and service details — all returning structured JSON.
Product Search and Category Browsing
The search_products endpoint accepts a query string and returns paginated results (0-indexed page, configurable limit) from PetSmart's catalog. Each product object includes id, name, brand, price (with number, formatted, and displayType), image URLs, bvAverageRating, bvReviewCount, and custom_category_names. The browse_category endpoint works similarly but takes a category string that must match PetSmart's taxonomy exactly, using > as the hierarchy separator — for example, 'Dog > Food > Dry Food'. Categories that don't match the taxonomy exactly return zero results.
Product Details and Reviews
get_product_details accepts a product_id string and returns the full record for that item: a long_description in HTML, images with both large and small URLs, masterProductID (used internally for review resolution), and the complete custom_category_names array. get_product_reviews takes the same product_id, resolves the BazaarVoice identifier automatically, and returns a Results array containing Id, Rating, Title, ReviewText, UserNickname, and SubmissionTime per review, plus a TotalResults count and an Includes object with related product and author data. Both offset and limit control pagination.
Store Finder and Pet Taxonomy
find_stores requires latitude and longitude coordinates and an optional radius in miles. It returns a stores array sorted by distance, with each entry including DistanceToStoreFromOrigin, store name, phone number, address fields, and a StoreServices list. get_pet_taxonomy takes no inputs and returns two arrays: breeds (each with BreedId, Description, SpeciesName, Size, IsAggressive, and IsBreathingChallenged) and colors (each with ColorId, Description, and IsActive). This taxonomy data is useful for filtering product searches or building breed-aware tooling.
- Build a pet food comparison tool using search_products to surface price and rating data across brands.
- Populate a category navigation tree from browse_category using the ' > ' hierarchy to mirror PetSmart's taxonomy.
- Aggregate customer sentiment by pulling Rating, ReviewText, and SubmissionTime from get_product_reviews.
- Locate the nearest PetSmart stores for a given address by passing latitude/longitude to find_stores.
- Retrieve store service availability (grooming, vet, training) from the StoreServices field in find_stores results.
- Use get_pet_taxonomy breed attributes like IsAggressive or IsBreathingChallenged to filter product recommendations for specific dog breeds.
- Track price changes on a product over time by polling get_product_details for the formatted price field.
| 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.