category query
The category
query has been deprecated. Use the categories query instead.
The category
query allows you to search for a single category definition or the entire category tree.
You cannot return the entire category tree if the total number of nodes in the request exceeds the value specified in the queryDepth
attribute defined in the GraphQL di.xml
file. By default, this value is 20. Query security further describes query depths.
Syntax
1
2
3
category (
id: int
): CategoryTree
Example usage
Return the category tree of a top-level category
The following query returns information about category ID 20
and four levels of subcategories. In the sample data, category ID 20
is assigned to the Women
category.
Request:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
{
category(id: 20) {
products {
total_count
page_info {
current_page
page_size
}
}
children_count
children {
id
level
name
path
children {
id
level
name
path
children {
id
level
name
path
children {
id
level
name
path
}
}
}
}
}
}
Response:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
{
"data": {
"category": {
"products": {
"total_count": 0,
"page_info": {
"current_page": 1,
"page_size": 20
}
},
"children_count": "8",
"children": [
{
"id": 22,
"level": 3,
"name": "Bottoms",
"path": "1/2/20/22",
"children": [
{
"id": 27,
"level": 4,
"name": "Pants",
"path": "1/2/20/22/27",
"children": []
},
{
"id": 28,
"level": 4,
"name": "Shorts",
"path": "1/2/20/22/28",
"children": []
}
]
},
{
"id": 21,
"level": 3,
"name": "Tops",
"path": "1/2/20/21",
"children": [
{
"id": 23,
"level": 4,
"name": "Jackets",
"path": "1/2/20/21/23",
"children": []
},
{
"id": 24,
"level": 4,
"name": "Hoodies & Sweatshirts",
"path": "1/2/20/21/24",
"children": []
},
{
"id": 25,
"level": 4,
"name": "Tees",
"path": "1/2/20/21/25",
"children": []
},
{
"id": 26,
"level": 4,
"name": "Bras & Tanks",
"path": "1/2/20/21/26",
"children": []
}
]
}
]
}
}
}
Return breadcrumb information
The following query returns breadcrumb information about the women’s Tops
category (id
= 25).
Request:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
category (
id: 25
) {
id
level
name
breadcrumbs {
category_id
category_name
category_level
category_url_key
category_url_path
}
}
}
Response:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"data": {
"category": {
"id": 25,
"level": 4,
"name": "Tees",
"breadcrumbs": [
{
"category_id": 20,
"category_name": "Women",
"category_level": 2,
"category_url_key": "women",
"category_url_path": "women"
},
{
"category_id": 21,
"category_name": "Tops",
"category_level": 3,
"category_url_key": "tops-women",
"category_url_path": "women/tops-women"
}
]
}
}
}
Input attributes
Attribute | Data type | Description |
---|---|---|
id |
Int | The category ID to use as the starting point of your category search |
Output attributes
The query returns a CategoryTree
object, which implements CategoryInterface
. The CategoryTree
object can contain the following attribute, as we as all attributes defined in CategoryInterface
:
Attribute | Data type | Description |
---|---|---|
children |
CategoryTree |
An array containing the next level of subcategories. By default, you can specify up to 10 levels of child categories |
Errors
Error | Description |
---|---|
Category doesn't exist |
The specified category ID value does not exist. |
Field "category" argument "id" requires type Int, found "XXX" |
The specified id argument value has the wrong type. |