# Expropiaciones (`legaltech/expropiaciones`) Actor

Automatiza la búsqueda de notificaciones sobre expropiaciones en el TEU del BOE, incluyendo expedientes de expropiación forzosa. Puedes buscar por referencia catastral.

- **URL**: https://apify.com/legaltech/expropiaciones.md
- **Developed by:** [Miguel González](https://apify.com/legaltech) (community)
- **Categories:** Automation
- **Stats:** 6 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## 🏗️ Búsqueda de anuncios de Expropiaciones en el BOE (TEU)

Este actor automatiza la búsqueda de notificaciones de expropiación forzosa publicadas en el Tablón Edictal Único (TEU) del Boletín Oficial del Estado (BOE).

Está diseñado para detectar resoluciones administrativas relacionadas con justiprecio, expedientes expropiatorios y proyectos de interés público, especialmente cuando el interesado figura como desconocido o no ha podido ser notificado personalmente.

### 🧾 ¿Qué hace este actor?

El actor expropiaciones revisa diariamente los anuncios publicados en el TEU del BOE y localiza notificaciones relacionadas con:

Resoluciones de justiprecio

Expedientes de expropiación forzosa

Publicaciones del Jurado Provincial de Expropiación

Proyectos de infraestructuras públicas o energéticas

Permite comprobar automáticamente si existe alguna notificación publicada en el día actual que afecte a fincas, parcelas o expedientes concretos.

### 🔍 ¿Qué puedes buscar?

Puedes buscar por cualquier dato habitual en anuncios de expropiación, como:

📄 Número de expediente

🏞️ Referencia catastral

🌍 Término municipal

🧱 Número de finca

🧾 Proyecto o actuación

🏢 Entidad beneficiaria

🏛️ Órgano expropiante

### 📌 Tipos de anuncios detectados

Este actor está optimizado para detectar anuncios como:

Notificación a interesado desconocido

Resolución de justiprecio

Expedientes del Jurado Provincial de Expropiación Forzosa

Proyectos de infraestructuras (energía, transporte, obras públicas)

#### Ejemplo de estructura de anuncio (ficticio)

Expediente de expropiación

Finca / parcela afectada

Referencia catastral

Término municipal

Proyecto de interés público

Órgano expropiante y beneficiario

### 💡 ¿Por qué usar este actor?

Las expropiaciones forzosas tienen impacto económico directo sobre propietarios y herederos, y muchas veces las notificaciones se publican únicamente en el BOE.

Si no se detectan a tiempo, pueden perderse plazos clave para impugnar el justiprecio o formular alegaciones.

Este actor te permite detectar estas publicaciones el mismo día en que aparecen.

#### Casos de uso habituales

🏠 Propietarios y herederos
Detecta expropiaciones que afectan a fincas o terrenos familiares.

🧑‍⚖️ Abogados urbanísticos y administrativos
Monitoriza expedientes expropiatorios y resoluciones de justiprecio.

🏗️ Ingenierías y consultoras
Control de proyectos de infraestructuras con afección a terceros.

🤖 Automatización de alertas
Integración con Zapier, Make o n8n para:

Alertas inmediatas

Creación de expedientes internos

Notificaciones por email

### 🚀 ¿Cómo se utiliza?

Buscar anuncios de Expropiaciones en el BOE es muy sencillo:

Haz clic en Try for free

Introduce los términos de búsqueda en el campo searchTerms

(Opcional) Ajusta la timezone

Haz clic en Run

Consulta los resultados en la pestaña Dataset

### 📝 Parámetros de Entrada
Parámetro	Tipo / Ejemplo	Descripción
searchTerms (Requerido)	["EXP-2025-001", "REF-CATASTRAL-XXXX", "T.M. EJEMPLO", "justiprecio"]	Nº de expediente, finca, referencia catastral, municipio o texto relevante
timezone (Opcional)	"Europe/Madrid"	Zona horaria usada para filtrar anuncios del día correcto. Por defecto: Europe/Madrid
#### 📥 Ejemplo de entrada
{
  "searchTerms": [
    "EXP-2025-001",
    "FINCA-123",
    "REF-CATASTRAL-XXXX",
    "justiprecio"
  ],
  "timezone": "Europe/Madrid"
}

### 📊 Resultados

El actor devuelve un resultado por cada coincidencia encontrada.

Si un término no aparece en ningún anuncio, no se devuelve ningún objeto.

Los resultados incluyen la información clave del expediente expropiatorio.

Los datos se entregan en un Dataset, listo para:

Descarga en JSON / CSV

Integración con otros actores

Automatización de procesos legales

### 💳 Coste y uso gratuito

Apify ofrece créditos gratuitos mensuales en el plan Free.

Puedes probar este actor sin coste y utilizarlo dentro de los límites del plan gratuito.

# Actor input Schema

## `searchTerms` (type: `array`):

Introduce la lista de NIFs, referencias catastrales, nombres, etc. que quieres buscar. Si existe un anuncio donde aparezca en el día actual devolverá los resultados.
## `timezone` (type: `string`):

Tu zona horaria (ej. 'Europe/Madrid') para asegurar que la búsqueda por fecha se realiza en el día correcto. Si se deja en blanco, se usará UTC.

## Actor input object example

```json
{
  "searchTerms": [
    "99999999R",
    "2043581VK4724C0001WU",
    "AYUNTAMIENTO DE MADRID"
  ],
  "timezone": "Europe/Madrid"
}
````

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "99999999R",
        "2043581VK4724C0001WU",
        "AYUNTAMIENTO DE MADRID"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("legaltech/expropiaciones").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchTerms": [
        "99999999R",
        "2043581VK4724C0001WU",
        "AYUNTAMIENTO DE MADRID",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("legaltech/expropiaciones").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "99999999R",
    "2043581VK4724C0001WU",
    "AYUNTAMIENTO DE MADRID"
  ]
}' |
apify call legaltech/expropiaciones --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=legaltech/expropiaciones",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Expropiaciones",
        "description": "Automatiza la búsqueda de notificaciones sobre expropiaciones en el TEU del BOE, incluyendo expedientes de expropiación forzosa. Puedes buscar por referencia catastral.",
        "version": "0.0",
        "x-build-id": "uxccdbnxJtXjGAW5f"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/legaltech~expropiaciones/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-legaltech-expropiaciones",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/legaltech~expropiaciones/runs": {
            "post": {
                "operationId": "runs-sync-legaltech-expropiaciones",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/legaltech~expropiaciones/run-sync": {
            "post": {
                "operationId": "run-sync-legaltech-expropiaciones",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "searchTerms"
                ],
                "properties": {
                    "searchTerms": {
                        "title": "Términos de Búsqueda",
                        "maxItems": 50,
                        "type": "array",
                        "description": "Introduce la lista de NIFs, referencias catastrales, nombres, etc. que quieres buscar. Si existe un anuncio donde aparezca en el día actual devolverá los resultados.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "timezone": {
                        "title": "Zona Horaria (Opcional)",
                        "type": "string",
                        "description": "Tu zona horaria (ej. 'Europe/Madrid') para asegurar que la búsqueda por fecha se realiza en el día correcto. Si se deja en blanco, se usará UTC.",
                        "default": "Europe/Madrid"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
