Salla Docs
List Categories
GEThttps://api.salla.dev/admin/v2/categoriesThis endpoint allows you to list all categories related to your store directly from this endpoint. Also, it allows you to filter them using a keyword, the endpoint would return any category which name matches this keyword.
Request
The Pagination page number
A keyword to filter categories by a specific name.
The status of the category, whether or not it is active or hidden
Returns the response with translations or items (or both). Takes values with separated comma or array of either items, translations or both in this case:with=items OR with=translations OR with[]=items&with[]=translations OR with=items,translations
Request samples
Responses
Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.
Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.
Category ID, is a unique identifier assigned to a specific product category, facilitating organized classification and efficient management of products within a similar group. List of categories can be found here.
Category name is a descriptive label assigned to a product category, aiding in clear identification and organization of related products. 🌐 Support multi-language
The category image
To help companies and merchants, Salla provides a “urls” attribute that has been added to different modules to guide the merchants to have the full URL of this module from both scopes, the dashboard scope as a store admin, and as a customer.
Category Parent ID refers to the unique identifier assigned to the parent category of a subcategory, establishing a hierarchical relationship between different levels of product classification.
The sequence or arrangement of categories when displayed to users.
The category status indicates whether the category is currently visible and accessible to users active or intentionally concealed from view hidden. It essentially controls whether the category is publicly displayed or kept private within the system.
Whether or not the category has hidden products.
The date where the category is updated in.
The subcategories list of the main category.
You will get this object in the response if you use with=translations query parameter.
Category translations are based on the store's enabled language locale. For instance, if the store supports both Arabic and English, the translations object will return two entries: ar for Arabic and en for English.
You will get this array in the response if you use with=items query parameter.
For a better response behavior as well as maintain the best security level, All retrieving API endpoints use a mechanism to retrieve data in chunks called pagination. Pagination working by return only a specific number of records in each response, and through passing the page number you can navigate the different pages.
Number of returned results.
Number of all results.
Number of results per page.
Number of current page.
Number of total pages.
Array of linkes to next and previous pages.
{
"status": 200,
"success": true,
"data": [
{
"id": 1390018242,
"name": "laptops",
"image": "https://salla-dev.s3.eu-central-1.amazonaws.com/Mvyk/QEFy9wUtKnazAVvm3t3WSYg2z1LTnxUzvrceFo2s.jpg",
"urls": {
"customer": "https://store.test/ar/jalal56s/laptops/c1390018242",
"admin": "/categories"
},
"parent_id": 0,
"sort_order": 0,
"status": "active",
"show_in": {
"app": true,
"salla_points": true
},
"has_hidden_products": true,
"update_at": "2024-10-24 13:24:48",
"metadata": {
"title": null,
"description": null,
"url": null
},
"sub_categories": []
},
{
"id": 115638743,
"name": "welcome jojo",
"image": null,
"urls": {
"customer": "https://store.test/ar/jalal56s/welcome-jojo/c115638743",
"admin": "/categories"
},
"parent_id": 0,
"sort_order": 0,
"status": "active",
"show_in": {
"app": true,
"salla_points": false
},
"has_hidden_products": false,
"update_at": "2024-10-24 14:19:55",
"metadata": {
"title": null,
"description": null,
"url": null
},
"sub_categories": []
},
{
"id": 40297589,
"name": "قطط",
"image": null,
"urls": {
"customer": "https://store.test/ar/jalal56s/قطط/c40297589",
"admin": "/categories"
},
"parent_id": 0,
"sort_order": 1,
"status": "active",
"show_in": {
"app": false,
"salla_points": false
},
"has_hidden_products": false,
"update_at": "2024-10-21 14:44:57",
"metadata": {
"title": "قطط",
"description": "welcome",
"url": "قطط"
},
"sub_categories": []
},
{
"id": 774382199,
"name": "طعام كلاب",
"image": null,
"urls": {
"customer": "https://store.test/ar/jalal56s/كلاب/c774382199",
"admin": "/categories"
},
"parent_id": 0,
"sort_order": 2,
"status": "hidden",
"show_in": {
"app": false,
"salla_points": false
},
"has_hidden_products": false,
"update_at": "2024-10-21 14:45:27",
"metadata": {
"title": null,
"description": null,
"url": null
},
"sub_categories": []
},
{
"id": 712043358,
"name": "العناية",
"image": null,
"urls": {
"customer": "https://store.test/ar/jalal56s/العناية/c712043358",
"admin": "/categories"
},
"parent_id": 0,
"sort_order": 3,
"status": "active",
"show_in": {
"app": false,
"salla_points": false
},
"has_hidden_products": false,
"update_at": "2024-10-21 14:51:38",
"metadata": {
"title": null,
"description": null,
"url": null
},
"sub_categories": []
},
{
"id": 537348185,
"name": "جميع الأقسام",
"image": null,
"urls": {
"customer": "https://store.test/ar/jalal56s/جميع-الأقسام/c537348185",
"admin": "/categories"
},
"parent_id": 0,
"sort_order": 3,
"status": "active",
"show_in": {
"app": true,
"salla_points": false
},
"has_hidden_products": false,
"update_at": "2024-09-06 13:01:49",
"metadata": {
"title": null,
"description": null,
"url": null
},
"sub_categories": []
},
{
"id": 355378101,
"name": "فساتين",
"image": null,
"urls": {
"customer": "https://store.test/ar/jalal56s/فساتين-سهرة/c355378101",
"admin": "/categories"
},
"parent_id": 0,
"sort_order": 4,
"status": "active",
"show_in": {
"app": true,
"salla_points": false
},
"has_hidden_products": false,
"update_at": "2024-09-07 14:34:09",
"metadata": {
"title": null,
"description": null,
"url": null
},
"sub_categories": []
}
],
"pagination": {
"count": 7,
"total": 7,
"perPage": 20,
"currentPage": 1,
"totalPages": 1,
"links": []
}
}