Endpoint Playground
Returns every filter PetSmart's catalog offers (about 120, such as brand, pet type, food form, size, flavor and life stage) with each filter's top values and product counts, scoped to the same search arguments /petsmart/search takes so the counts describe the result set that search would return. facet_names always lists every valid filter name for /petsmart/search's filter parameter. Pass facet to list one filter's values (up to 1,000) and facet_query to search within them, for example brand names containing blue; numeric_ranges reports the spread of numeric attributes such as price and rating over the scoped products. An unknown facet returns a 400. Pass country=ca for the Canadian catalog.
5 Nov 2026: Single record response; 4 fields had a value in every checked item.
Sample value profiles: total_results: 0; country: “us”; facet_names: 123 entries.
curl 'https://api.crawlora.net/api/v1/petsmart/search/filters?country=us' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| country | string | No | us | Optional catalog: us (default) or ca for the Canadian store, which has its own products (about 9,000), categories, filters and prices. |
| query | string | No | Optional keyword. | |
| category | string | No | Optional category path, from /petsmart/categories' path field (for example Dog > Food > Dry Food). Includes the category's descendants. A path not in the directory returns a 400. | |
| brand | string | No | Optional exact brand name. Find values with /petsmart/search/filters using facet=brand and facet_query. | |
| filter | string | No | Optional catalog filters as name:value, repeatable (for example customPet:Dog). Names and values come from /petsmart/search/filters; an unknown name returns a 400. Different names combine with AND; repeating one name combines its values with OR. | |
| min_price | number | No | Optional minimum price in dollars. | |
| max_price | number | No | Optional maximum price in dollars. | |
| min_rating | number | No | Optional minimum average customer rating, 0 to 5. | |
| facet | string | No | Optional single filter name to list values for, from facet_names. Without it every filter is returned with its top values. | |
| facet_query | string | No | Optional text to search within the values of facet, for example brand names containing blue. Requires facet. | |
| limit | integer | No | Optional values per filter. Defaults to 10 (maximum 100) for all filters; with facet, maximum 1000, or 100 together with facet_query. |
{
"code": 200,
"msg": "OK",
"data": {
"country": "us",
"total_results": 944,
"facet_names": [
"brand",
"customPet",
"foodForms"
],
"facets": [
{
"name": "brand",
"values": [
{
"value": "Blue Buffalo",
"count": 82
},
{
"value": "Royal Canin",
"count": 74
}
]
}
],
"numeric_ranges": [
{
"name": "price.number",
"min": 0.99,
"max": 364.99,
"avg": 57.2
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.