Docs menu

PetSmart API endpoint

PetSmart Categories API

Returns PetSmart's category directory: every category path (for example Dog > Food > Dry Food) with its name, parent path and depth, about 1,400 in all, hierarchical so a parent path covers its descendants. A category's path is the value /petsmart/search and /petsmart/search/filters take as category. Filter with query (text in the path), parent (descendants of a path) and depth, and page through with page and limit. Ancestor paths that the directory does not list itself are included, since products carry them and they are valid category filters. Pass country=ca for the Canadian catalog.

GETapiKey1 credit/requestPetSmartpetsmart.categoriesResponseDoc/petsmart/categories

Endpoint facts

Method: GET
API path: /petsmart/categories
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: PetSmart
Response schema: #/definitions/petsmart.categoriesResponseDoc

PetSmart product catalog API Try PetSmart Categories API in Playground PetSmart API documentation

How this endpoint behaves

Products carry every ancestor of their category, so ancestor paths the directory does not list itself (for example Dog > Food) are included as valid category filters; they have no key or id.

Query parameters (all optional): country (us default or ca; the Canadian directory has about 850 paths), query (text in the path, case-insensitive), parent (a path; keeps only its descendants; an unknown path returns a 400), depth (exact depth, 1 for top level), page (1-based, default 1) and limit (default 100, maximum 500).

Sampled response

Request, 5 Nov 2026: GET /petsmart/categories?depth=1&limit=40
Items in categories: 32
Fields filled in every checked item: 3
Fields empty in some or all items: 2

Field	Filled in, of 32 checked	Values in the sample
path	32	“Bird” and 31 other values
name	32	“Bird” and 31 other values
depth	32	1
key	26
id	11

Request parameters

Parameter	Type	Required	Default	Description	Example
country	string	No		Optional catalog: us (default) or ca for the Canadian store, which has its own products (about 9,000), categories, filters and prices. Allowed values: us, ca.	us
query	string	No		Optional text; keeps categories whose path contains it (case-insensitive).	treats
parent	string	No		Optional category path; keeps only its descendants.	Dog > Food
depth	integer	No		Optional exact depth: 1 for top-level categories, 2 for their children, and so on.	2
page	integer	No	1	Optional 1-based page number. Defaults to 1.	1
limit	integer	No	100	Optional categories per page. Defaults to 100, maximum 500.	100
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/petsmart/categories?country=us&query=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "us",
    "page": 1,
    "limit": 100,
    "total_results": 9,
    "categories": [
      {
        "path": "Dog > Food > Dry Food",
        "name": "Dry Food",
        "parent": "Dog > Food",
        "depth": 3,
        "key": "100246-us",
        "id": 100246
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/petsmart.categoriesResponseDoc

Field	Type	Required	Description
code	integer	No	Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	petsmart.CategoriesResponse	No
data.categories	array	No
data.categories[].depth	integer	No
data.categories[].id	integer	No
data.categories[].key	string	No	Key is PetSmart's category key and ID its numeric part.
data.categories[].name	string	No
data.categories[].parent	string	No	Parent is the path of the parent category; empty for a top-level one.
data.categories[].path	string	No	Path is the value /petsmart/search takes as category, for example "Dog > Food > Dry Food". It includes the category's descendants.
data.country	string	No
data.limit	integer	No
data.page	integer	No
data.total_results	integer	No
msg	unknown	No	Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/petsmart/categories?country=us&query=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More PetSmart endpoint docs PetSmart product catalog API PetSmart Product API documentation PetSmart Product Inventory API documentation PetSmart Search API documentation PetSmart Search Filters API documentation PetSmart Suggest API documentation

Open in Playground Back to group

Docs menu

PetSmart API endpoint

PetSmart Categories API

GETapiKey1 credit/requestPetSmartpetsmart.categoriesResponseDoc/petsmart/categories

Endpoint facts

Method: GET
API path: /petsmart/categories
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: PetSmart
Response schema: #/definitions/petsmart.categoriesResponseDoc

PetSmart product catalog API Try PetSmart Categories API in Playground PetSmart API documentation

How this endpoint behaves

Products carry every ancestor of their category, so ancestor paths the directory does not list itself (for example Dog > Food) are included as valid category filters; they have no key or id.

Sampled response

Request, 5 Nov 2026: GET /petsmart/categories?depth=1&limit=40
Items in categories: 32
Fields filled in every checked item: 3
Fields empty in some or all items: 2

Field	Filled in, of 32 checked	Values in the sample
path	32	“Bird” and 31 other values
name	32	“Bird” and 31 other values
depth	32	1
key	26
id	11

Request parameters

Parameter	Type	Required	Default	Description	Example
country	string	No		Optional catalog: us (default) or ca for the Canadian store, which has its own products (about 9,000), categories, filters and prices. Allowed values: us, ca.	us
query	string	No		Optional text; keeps categories whose path contains it (case-insensitive).	treats
parent	string	No		Optional category path; keeps only its descendants.	Dog > Food
depth	integer	No		Optional exact depth: 1 for top-level categories, 2 for their children, and so on.	2
page	integer	No	1	Optional 1-based page number. Defaults to 1.	1
limit	integer	No	100	Optional categories per page. Defaults to 100, maximum 500.	100
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/petsmart/categories?country=us&query=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": "us",
    "page": 1,
    "limit": 100,
    "total_results": 9,
    "categories": [
      {
        "path": "Dog > Food > Dry Food",
        "name": "Dry Food",
        "parent": "Dog > Food",
        "depth": 3,
        "key": "100246-us",
        "id": 100246
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/petsmart.categoriesResponseDoc

Field	Type	Required	Description
code	integer	No	Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	petsmart.CategoriesResponse	No
data.categories	array	No
data.categories[].depth	integer	No
data.categories[].id	integer	No
data.categories[].key	string	No	Key is PetSmart's category key and ID its numeric part.
data.categories[].name	string	No
data.categories[].parent	string	No	Parent is the path of the parent category; empty for a top-level one.
data.categories[].path	string	No	Path is the value /petsmart/search takes as category, for example "Dog > Food > Dry Food". It includes the category's descendants.
data.country	string	No
data.limit	integer	No
data.page	integer	No
data.total_results	integer	No
msg	unknown	No	Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/petsmart/categories?country=us&query=coffee&page=1&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

PetSmart Categories API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

PetSmart Categories API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related