Categorías
Una categoría permite agrupar productos dentro de la tienda para facilitar la navegación y organización del catálogo.
Propiedades
| Propiedad | Descripción |
|---|---|
| id | Identificador único de la categoría |
| title | Título de la categoría |
| description | Descripción de la categoría |
| handle | URL de la categoría |
| seo_title | Título utilizado para SEO |
| seo_description | Descripción utilizada para SEO |
| parent | ID de la categoría padre |
| subcategories | Lista de subcategorías |
| google_shopping_category | Categoría utilizada para Google Shopping |
| created_at | Fecha de creación (ISO 8601) |
| updated_at | Fecha de última actualización (ISO 8601) |
Endpoints
GET /categories
Obtiene una lista de categorías.
Parámetros de query
| Parámetro | Descripción |
|---|---|
| ids | Lista de IDs separados por comas |
| since_id | Registros posteriores a este ID |
| q | Buscar por title o handle |
| page | Número de página |
| per_page | Cantidad de resultados por página |
Ejemplo
GET /categories
HTTP/1.1 200 OK
{
"pagination": {
"total": 120,
"page": 1,
"per_page": 50,
"next_page": "https://developers.tiendanegocio.com/v1/categories?page=2&per_page=50"
},
"results": [
{
"id": 101,
"title": {
"es": "Ropa Deportiva"
},
"description": {
"es": "Indumentaria ideal para entrenar y hacer actividad física."
},
"handle": {
"es": "ropa-deportiva"
},
"seo_title": "Ropa deportiva de calidad",
"seo_description": "Encontrá la mejor ropa deportiva para entrenar al mejor precio.",
"parent": 0,
"subcategories": [],
"google_shopping_category": "Apparel & Accessories > Clothing",
"created_at": "2026-03-19T10:30:00Z",
"updated_at": "2026-03-19T10:30:00Z"
}
]
}
GET /categories/{id}
Obtiene una categoría por ID.
Ejemplo
GET /categories/101
HTTP/1.1 200 OK
{
"id": 101,
"title": {
"es": "Ropa Deportiva"
},
"description": {
"es": "Indumentaria ideal para entrenar y hacer actividad física."
},
"handle": {
"es": "ropa-deportiva"
},
"seo_title": "Ropa deportiva de calidad",
"seo_description": "Encontrá la mejor ropa deportiva para entrenar al mejor precio.",
"parent": 0,
"subcategories": [],
"google_shopping_category": "Apparel & Accessories > Clothing",
"created_at": "2026-03-19T10:30:00Z",
"updated_at": "2026-03-19T10:30:00Z"
}
GET /categories/{id}/products
Obtiene los productos asociados a una categoría.
Ejemplo
GET /categories/101/products
HTTP/1.1 200 OK
{
"pagination": {
"total": 120,
"page": 1,
"per_page": 50,
"next_page": "https://developers.tiendanegocio.com/v1/categories/101/products?page=2&per_page=50"
},
"results": [
{
"id": 101,
"name": {
"es": "Remera lisa"
},
"description": {
"es": "Remera lisa"
},
"handle": {
"es": "remera-lisa"
},
"published": true,
"free_shipping": false,
"requires_shipping": true,
"price": "5000",
"stock": null,
"sku": "string",
"created_at": "2026-03-19T12:58:55.000Z",
"updated_at": "2026-03-19T12:58:55.000Z",
"dimensions": {
"weight": 0,
"depth": 0,
"width": 0,
"height": 0
},
"variants": [],
"images": [
{
"id": 1,
"src": "https://cdn.v2.tiendanegocio.com/gallery/76/img_76_1920a8a3edf.webp?class=sm",
"position": 0,
"product_id": 101
}
],
"categories": [
{
"id": 1,
"name": {
"es": "Ropa Deportiva"
},
"description": {
"es": "Indumentaria ideal para entrenar y hacer actividad física."
},
"handle": {
"es": "ropa-deportiva"
},
"parent": null,
"subcategories": [],
"google_shopping_category": null,
"created_at": "2026-03-19T16:27:08.000Z",
"updated_at": "2026-03-19T17:11:43.007Z"
}
],
"brand": null,
"video_url": "https://cdn.v2.tiendanegocio.com/string",
"seo_title": "string",
"seo_description": "string",
"attributes": [],
}
]
}
POST /categories
Crea una nueva categoría.
Ejemplo de request
{
"title": {
"es": "Ropa Deportiva"
},
"description": {
"es": "Indumentaria ideal para entrenar y hacer actividad física."
},
"handle": {
"es": "ropa-deportiva"
},
"seo_title": "Ropa deportiva de calidad",
"seo_description": "Encontrá la mejor ropa deportiva para entrenar al mejor precio.",
"parent_id": 0
}
Respuesta
HTTP/1.1 201 OK
{
"id": 101,
"title": {
"es": "Ropa Deportiva"
},
"description": {
"es": "Indumentaria ideal para entrenar y hacer actividad física."
},
"handle": {
"es": "ropa-deportiva"
},
"seo_title": "Ropa deportiva de calidad",
"seo_description": "Encontrá la mejor ropa deportiva para entrenar al mejor precio.",
"parent": null,
"subcategories": [],
"google_shopping_category": "Apparel & Accessories > Clothing",
"created_at": "2026-03-19T10:30:00Z",
"updated_at": "2026-03-19T10:30:00Z"
}
PUT /categories/{id}
Actualiza una categoría existente.
Ejemplo
PUT /categories/101
{
"title": {
"es": "Ropa Deportiva"
},
"description": {
"es": "Indumentaria ideal para entrenar y hacer actividad física."
},
"handle": {
"es": "ropa-deportiva"
},
"seo_title": "Ropa deportiva de calidad",
"seo_description": "Encontrá la mejor ropa deportiva para entrenar al mejor precio."
}
Respuesta
HTTP/1.1 200 OK
{
"id": 101,
"title": {
"es": "Ropa Deportiva"
},
"description": {
"es": "Indumentaria ideal para entrenar y hacer actividad física."
},
"handle": {
"es": "ropa-deportiva"
},
"seo_title": "Ropa deportiva de calidad",
"seo_description": "Encontrá la mejor ropa deportiva para entrenar al mejor precio.",
"parent": null,
"subcategories": [],
"google_shopping_category": "Apparel & Accessories > Clothing",
"created_at": "2026-03-19T10:30:00Z",
"updated_at": "2026-03-19T10:30:00Z"
}
DELETE /categories/{id}
Elimina una categoría.
Ejemplo
DELETE /categories/101