Saltar al contenido
Servicio independiente · No es un sitio oficial del BOEDatos a 22 de noviembre de 2026, 05:10 UTC
Subastas BOEAPI

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.

· 2 min de lectura

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 portalSe busca también como
Alicante/AlacantAlicante
Valencia/ValènciaValencia
Castellón/CastellóCastellón
Araba/ÁlavaÁlava
Illes BalearsBaleares
A CoruñaLa Coruña
LleidaLérida
Bizkaia, GipuzkoaVizcaya, 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

  • normaliza se queda con la primera forma del nombre, en minúsculas y sin tildes. Con eso «Alicante/Alacant», «Alicante» y «alicante» son lo mismo.
  • bienes recorre los bienes de la subasta sin importar si van en properties o en lots. Los bloques llegan como cadenas con JSON dentro, de ahí el json.loads.
  • subastas pagina el listado completo, de 500 en 500.
  • filtra devuelve 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.

Configurar cookies

Elige qué categorías permites. Puedes cambiar de opinión cuando quieras desde el enlace «Configurar cookies» del pie de página. Detalle de cada cookie en la política de cookies.