La API de SOLUM

Lo mismo que la web pública, en JSON, para bancos, tasadoras y aplicaciones: municipios, parcelas y lo que cabe y se podría pagar por su suelo, con las mismas fuentes y fechas. Solo lectura.

Qué se puede preguntar

Ruta	Qué devuelve
GET`/api/v1/publico/municipios?q=`	Municipios por su nombre, con su código del Catastro.
GET`/api/v1/publico/suelo-oculto/{codigo}`	El recuento semanal del suelo urbano infrautilizado de un municipio.
GET`/api/v1/publico/direccion?municipio=&q=`	La parcela catastral de una calle y número.
GET`/api/v1/publico/referencia?rc=`	Una parcela por su referencia catastral.
GET`/api/v1/publico/valorar?municipio=&referencia=`	Qué cabe y cuánto podría pagar un promotor por el suelo, con la cuenta.
GET`/api/v1/publico/solar?municipio=&referencia=`	La valoración completa de un solar para su propietario.
POST`/api/v1/mcp`	Servidor MCP (JSON-RPC 2.0) para el asistente de IA de quien lo use. Cuenta cada `tools/call`. Conecta tu asistente.
GET`/api/v1/uso`	Tus consultas de hoy, tu tope y lo que te queda. No gasta consultas.
POST`/api/v1/lote`	Hasta 1.000 referencias catastrales de una vez, con clave. Se trabaja por detrás y contesta con su id.
GET`/api/v1/lote/{id}`	Cómo va un lote. Al terminar, `/api/v1/lote/{id}/resultado?formato=json`, `csv` o `parquet`. No gasta consultas.
GET`/api/v1/esquema`	Cada campo: tipo, unidad, fuente y si hay que comprobarlo. Sin clave y gratis.
GET`/api/v1/publico/provincia/{codigo}.parquet`	Lo publicado de una provincia, un municipio por fila, en Parquet (código del INE de dos cifras).

Carteras enteras: el lote

Manda tus referencias en {"referencias": ["3131064VJ3933S", …]}; si sabes el municipio, como {"referencia": …, "municipio": "46250"}, y va más rápido. Cada referencia distinta es una consulta de tu tope de hoy y se cobran al recibir el lote: si no caben todas, no se cobra ninguna y la respuesta es 429. Las que SOLUM no consigue calcular por un fallo suyo o del Catastro se devuelven al terminar. Cada clave puede tener dos lotes sin terminar a la vez, y el resultado se guarda siete días.

Con clave o sin ella

Sin clave, la API está abierta con un límite por dirección IP, pensado para una persona que consulta a mano. Con clave, el límite es el tope diario de tu clave, que se renueva a medianoche, hora de Madrid. Al pasarlo, la respuesta es 429 con cuándo se renueva (y la cabecera Retry-After, en segundos). Una clave que no existe o está revocada da 401.

La clave va siempre en una cabecera, nunca en la dirección: Authorization: Bearer <clave> o X-Api-Key: <clave>. Cada petición cuenta como una consulta; las que fallan por SOLUM no.

Cómo se pide una clave

Escribe a hola@aim-solum.ai diciendo quién eres, para qué la quieres y cuántas consultas al día calculas. La clave se entrega una sola vez: guárdala, porque SOLUM solo guarda su huella y no puede volver a dártela.

Pedir una clave

Un ejemplo

curl -H "Authorization: Bearer $SOLUM_CLAVE" \
  "https://www.aim-solum.ai/api/v1/publico/valorar?municipio=CODIGO&referencia=REFERENCIA"

curl -H "Authorization: Bearer $SOLUM_CLAVE" "https://www.aim-solum.ai/api/v1/uso"

curl -H "Authorization: Bearer $SOLUM_CLAVE" -H "Content-Type: application/json" \
  -d '{"referencias": ["REFERENCIA_1", "REFERENCIA_2"]}' "https://www.aim-solum.ai/api/v1/lote"

Son estimaciones, no tasaciones. Cada cifra lleva su fuente y su fecha: cítalas. Cada parcela hay que comprobarla en el ayuntamiento. Qué significa cada cifra.