Input schema (JSON)
{
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"description": "Texto libre (título, descripción, calle, referencias, marca/modelo…)."
},
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"orden": {
"type": "string",
"description": "fecha_celebracion_asc|desc, fecha_insercion_asc|desc, fecha_actualizacion_asc|desc, valoracion_asc|desc, puja_asc|desc, deposito_asc|desc. Sin orden: relevancia."
},
"filtros": {
"type": "object",
"properties": {
"marca": {
"type": "string",
"description": "Marca del vehículo como slug (\"renault\", \"mercedes-benz\"); lista en opciones_filtros (marcas). Solo vehículos."
},
"pujas": {
"enum": [
"importe",
"importe_no_publicado",
"secreta",
"sin_pujas",
"desconocida",
"con_pujas"
],
"type": "string",
"description": "Estado de la puja del bien."
},
"estado": {
"type": "string",
"description": "activas, celebrandose, finalizadas, proximas, suspendidas, canceladas, o un slug de estado concreto (activa_con_pujas…). Sin estado, en el MCP: activas y próximas apertura (si el plan las incluye), y en el API REST: todas menos próximas. Para subastas ya celebradas, pon finalizadas."
},
"comarca": {
"type": "string",
"description": "Slug de comarca (\"maresme-barcelona\"), de la lista comarcas de listar_municipios. Excluyente con municipio."
},
"deposito": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Depósito requerido en euros: {min, max}.",
"additionalProperties": false
},
"municipio": {
"type": "string",
"description": "Nombre exacto del municipio, tal como lo devuelve listar_municipios."
},
"provincia": {
"type": "string",
"description": "Slug (\"a-coruna\") o nombre exacto (\"A Coruña\"). Lista en listar_provincias."
},
"reclamada": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Cantidad reclamada en euros: {min, max}, ambos incluidos. Es la del lote o, si no la hay, la de toda la subasta. Con el filtro quedan fuera los bienes sin cantidad reclamada.",
"additionalProperties": false
},
"tipo_bien": {
"type": "string",
"description": "Slug del tipo de bien (vivienda, garaje, local-comercial, vehiculo…) o un grupo: inmuebles, muebles, todos. Lista en opciones_filtros."
},
"superficie": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Superficie en m² según catastro: {min, max} enteros, min incluido y max excluido. Construida; en solares y fincas rústicas, la de la parcela. Solo inmuebles; quedan fuera los bienes sin dato.",
"additionalProperties": false
},
"valoracion": {
"type": "object",
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"description": "Valor de subasta en euros: {min, max}; basta uno de los dos.",
"additionalProperties": false
},
"bienes_lote": {
"enum": [
"uno",
"varios"
],
"type": "string",
"description": "Bienes del lote: uno (lote de un solo bien) o varios."
},
"clase_subasta": {
"type": "integer",
"description": "Origen de la subasta: 2 BOE judiciales, 3 notariales, 4 diputaciones, 5 ayuntamientos, 6 consejos comarcales, 7 Seguridad Social, 11 agencias tributarias autonómicas, 12 AEAT, 13 administraciones generales."
},
"procedimiento": {
"type": "integer",
"description": "Código de procedimiento (lista en opciones_filtros)."
},
"fecha_insercion": {
"type": "object",
"properties": {
"desde": {
"type": "string"
},
"hasta": {
"type": "string"
}
},
"description": "Fecha de publicación en AlertaSubastas: {desde, hasta}.",
"additionalProperties": false
},
"fecha_celebracion": {
"type": "object",
"properties": {
"desde": {
"type": "string"
},
"hasta": {
"type": "string"
}
},
"description": "Fecha de conclusión de la subasta: {desde, hasta} en YYYY-MM-DD.",
"additionalProperties": false
},
"vivienda_habitual": {
"enum": [
"si",
"no",
"desconocido"
],
"type": "string",
"description": "Si el inmueble es la vivienda habitual del deudor según el BOE."
},
"fecha_actualizacion": {
"type": "object",
"properties": {
"desde": {
"type": "string"
},
"hasta": {
"type": "string"
}
},
"description": "Último cambio de estado: {desde, hasta}, YYYY-MM-DD o ISO 8601.",
"additionalProperties": false
}
},
"description": "Filtros estructurados. Todos opcionales."
}
},
"additionalProperties": false
}