Cómo filtrar subastas por provincia y tipo de bien con la API
La provincia de una subasta está dentro de cada bien, con el nombre que usa el portal. Cómo leerla, qué variantes aparecen y un filtro completo en Python.
Lo primero que quiere hacer casi todo el que integra la API es quedarse con las subastas de su zona. Se puede, pero hay que saber dónde está el dato, porque no está donde uno lo buscaría.
Dónde está la provincia
No en la raíz de la subasta. El campo province_id que aparece ahí está reservado y no sirve para filtrar.
La provincia está en cada bien, con el nombre que publica el portal:
- En subastas sin lotes, en
properties[].property, en el par «Provincia». - En subastas por lotes, en
lots[].datos_bien, en el mismo par.
Una subasta puede tener bienes en más de una provincia, aunque es poco frecuente.
Los nombres son los del portal
El portal usa las denominaciones oficiales, y algunas no son las que uno escribiría de memoria:
| Nombre en el portal | Se busca también como |
|---|---|
| Alicante/Alacant | Alicante |
| Valencia/València | Valencia |
| Castellón/Castelló | Castellón |
| Araba/Álava | Álava |
| Illes Balears | Baleares |
| A Coruña | La Coruña |
| Lleida | Lérida |
| Bizkaia, Gipuzkoa | Vizcaya, Guipúzcoa |
Además, en un puñado de fichas aparecen variantes sueltas como «Alicante», «Valencia», «Baleares» o «Lérida» en lugar de la forma habitual. Son pocas, menos de una de cada mil, pero un filtro por igualdad exacta las pierde. Lo seguro es normalizar.
El filtro
import json
import os
import unicodedata
import requests
BASE = os.environ["BASE"]
CABECERAS = {"Authorization": os.environ["TOKEN"], "Accept": "application/json"}
def normaliza(texto):
"""'Alicante/Alacant' -> 'alicante'; 'València' -> 'valencia'."""
base = (texto or "").split("/")[0].strip().lower()
return "".join(c for c in unicodedata.normalize("NFD", base)
if unicodedata.category(c) != "Mn")
def pares(lista):
return {k: v for par in (lista or []) for k, v in par.items()}
def bienes(subasta):
"""Devuelve los datos de cada bien, venga de properties o de lots."""
props = json.loads(subasta["properties"] or "[]")
lotes = json.loads(subasta["lots"] or "[]")
for bien in props:
yield bien["title"], pares(bien["property"]), bien.get("superficie")
for lote in lotes:
yield lote["titulo_bien"], pares(lote["datos_bien"]), None
def subastas():
pagina = 1
while True:
r = requests.get(f"{BASE}/api/auctions", headers=CABECERAS,
params={"page": pagina}, timeout=60)
r.raise_for_status()
datos = r.json()
yield from datos["data"]
if pagina >= datos["last_page"]:
break
pagina += 1
def filtra(provincia, tipo_bien=None):
buscada = normaliza(provincia)
for s in subastas():
for titulo, datos, superficie in bienes(s):
if normaliza(datos.get("Provincia")) != buscada:
continue
if tipo_bien and f"({tipo_bien})" not in titulo:
continue
yield s["auction_number"], titulo, datos.get("Localidad"), superficie
break
for fila in filtra("Alicante", tipo_bien="Vivienda"):
print(*fila, sep=" | ")
Qué hace cada parte
normalizase queda con la primera forma del nombre, en minúsculas y sin tildes. Con eso «Alicante/Alacant», «Alicante» y «alicante» son lo mismo.bienesrecorre los bienes de la subasta sin importar si van enpropertieso enlots. Los bloques llegan como cadenas con JSON dentro, de ahí eljson.loads.subastaspagina el listado completo, de 500 en 500.filtradevuelve cada subasta una sola vez, en cuanto uno de sus bienes cumple las condiciones.
El tipo de bien va entre paréntesis en el título de cada bien: «Bien 1 - Inmueble (Vivienda)». Los valores más frecuentes son Vivienda, Garaje, Finca rústica, Local comercial, Solar, Trastero y Nave industrial.
Para no descargarlo todo cada vez
El listado completo son algo más de treinta páginas. Descargarlo una vez al día es razonable; hacerlo cada hora, no.
El patrón eficiente es guardar en tu base de datos el resultado del filtro y, entre una descarga completa y la siguiente, consultar solo el histórico de cambios de las subastas que te interesan. Está explicado en el artículo sobre alertas de pujas.
Solo las abiertas
Para quedarte con las que siguen en celebración, compara la fecha de conclusión con el momento actual. La referencia exacta es el valor ISO que acompaña a «Fecha de conclusión» dentro de general_information; la documentación explica el formato.
Si solo quieres una idea de cuántas hay en cada provincia antes de escribir una línea de código, las cifras por provincia lo muestran ya agregado.