API de Subastio
Accede programáticamente a todos los datos de subastas judiciales en España.
REST API
JSON
10.000 req/día
Autenticación
Todas las peticiones requieren una API key en la cabecera Authorization. Puedes gestionar tus keys desde tu perfil.
curl -X POST https://lnfmkeycpnbecomkvgqr.supabase.co/functions/v1/get-auctions \
-H "apikey: TU_ANON_KEY" \
-H "Authorization: Bearer sk_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{}'La cabecera apikey es tu clave pública (anon key) del proyecto. La cabecera Authorization es tu API key privada (sk_live_...).
Las API keys solo se muestran una vez al crearlas. Guárdalas en un lugar seguro.
Límites
10.000
peticiones / día
20
resultados / página (máx. 100)
429
si superas el límite
Endpoints
POST/get-auctions
Buscar y filtrar subastas.
Parámetros (body JSON)
| Parámetro | Tipo | Descripción |
|---|---|---|
| page | number | Offset (default: 0) |
| per_page | number | Resultados por página (default: 20, máx: 100) |
| filters.search | string | Búsqueda por texto en título |
| filters.status | string | "active", "upcoming", "ended", "all" |
| filters.category_id | uuid | Filtrar por categoría |
| filters.province_id | uuid | Filtrar por provincia |
| filters.city_id | uuid | Filtrar por ciudad |
| filters.price_min | number | Precio mínimo (€) |
| filters.price_max | number | Precio máximo (€) |
| filters.brands | string[] | Marcas (vehículos) |
| filters.fuel_types | string[] | Tipos de combustible |
| filters.occupation_status | string | Estado de ocupación |
| filters.min_discount | number | Descuento mínimo vs tasación (%) |
| filters.surface_min | number | Superficie mínima (m²) |
| filters.surface_max | number | Superficie máxima (m²) |
| sort.field | string | "created_at", "display_price", "end_date", "discount_pct" |
| sort.direction | string | "asc" o "desc" |
Respuesta
{
"auctions": [
{
"id": "uuid",
"title": "Piso en Madrid",
"slug": "piso-en-madrid-abc123",
"status": "active",
"display_price": 150000,
"end_date": "2025-03-15T18:00:00Z",
"category": { "id": "uuid", "name": "Pisos", "slug": "pisos" },
"province": { "id": "uuid", "name": "Madrid", "slug": "madrid" },
"attributes": {
"surface_m2": 85,
"occupation_status": "libre",
"cadastral_ref": "1234567AB1234S0001HI",
...
},
...
}
],
"nextPage": 20,
"totalCount": 1532,
"tier": "api"
}Ejemplo
curl -X POST https://lnfmkeycpnbecomkvgqr.supabase.co/functions/v1/get-auctions \
-H "apikey: TU_ANON_KEY" \
-H "Authorization: Bearer sk_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{
"filters": {
"status": "active",
"province_id": "uuid-de-madrid",
"price_max": 200000
},
"sort": { "field": "end_date", "direction": "asc" },
"per_page": 50
}'POST/get-auction-detail
Obtener detalle completo de una subasta.
Parámetros (body JSON)
| Parámetro | Tipo | Descripción |
|---|---|---|
| slug | string | Slug o UUID de la subasta (requerido) |
Ejemplo
curl -X POST https://lnfmkeycpnbecomkvgqr.supabase.co/functions/v1/get-auction-detail \
-H "apikey: TU_ANON_KEY" \
-H "Authorization: Bearer sk_live_tu_api_key" \
-H "Content-Type: application/json" \
-d '{ "slug": "piso-en-madrid-abc123" }'Códigos de error
| Código | Descripción |
|---|---|
| 400 | Parámetros inválidos |
| 401 | API key no proporcionada o inválida |
| 403 | Tier insuficiente (se requiere plan API) |
| 429 | Límite diario superado |
| 500 | Error interno del servidor |
¿Necesitas acceso API?
Ver planes