Subito.it Categories API Documentation List every Subito.it category with its integer key, name, slug and macro group. Use the key as c in search. Entries with is_group true are macro groups (for example Motori) and carry no macrocategory_id. Category 2 (Auto) is listed but searched through the Subito Motori API.
Run this endpoint
Endpoint
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"count": 45,
"categories": [
{
"key": 1,
"name": "MOTORI",
"slug": "motori",
"is_group": true
},
{
"key": 2,
"name": "Auto",
"slug": "auto",
"weight": 1,
"is_group": false,
"macrocategory_id": 1
},
{
"key": 5,
"name": "Accessori Auto",
"slug": "accessori-auto",
"weight": 2,
"is_group": false,
"macrocategory_id": 1
},
{
"key": 3,
"name": "Moto e Scooter",
"slug": "moto-e-scooter",
"weight": 3,
"is_group": false,
"macrocategory_id": 1
}
]
},
"meta": {
"billable": true,
"endpoint_family": "categories"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Invalid Source Response
Subito answered with a shape that no longer matches the documented contract. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "categories"
},
"error": {
"code": "PARSER_DRIFT",
"message": "Subito returned an unexpected response. Please retry later."
},
"success": false
}Service Unavailable
The upstream service is temporarily unavailable. Please retry shortly.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "categories"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Subito service is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.