# Búsqueda de Sanciones OFAC (lista SDN) (`bite-sized-insights/ofac-sanctions-search-es`) Actor

Verifique nombres de personas y entidades contra la lista SDN de la OFAC del Tesoro de EE. UU. Obtenga coincidencias estructuradas con alias, programas, países, fechas de nacimiento y documentos de identidad. Filtre por programa, país, tipo de entidad y fecha.

- **URL**: https://apify.com/bite-sized-insights/ofac-sanctions-search-es.md
- **Developed by:** [bite-sized-insights](https://apify.com/bite-sized-insights) (community)
- **Categories:** Business, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 match returneds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

***Verifique nombres contra la lista de Nacionales Especialmente Designados (SDN) de la OFAC del Tesoro de EE. UU. y obtenga coincidencias estructuradas: alias, programas de sanciones, direcciones y datos de identificación.***

📖 Versión en inglés disponible: [OFAC Sanctions Search](https://apify.com/bite-sized-insights/ofac-sanctions-search)

Simplemente proporcione una lista de nombres y obtenga cada entrada SDN cuyo nombre o alias registrado coincida, con filtros opcionales por programa, país, tipo de entidad y fecha de nacimiento.

No requiere inicio de sesión. No necesita cookies. Tarificación por evento.

### ¿Por qué elegir este Actor?

**"Verifique nombres contra la lista SDN de la OFAC en segundos"**

Nuestro Actor de Búsqueda de Sanciones OFAC ofrece:

- **Datos oficiales de la OFAC**: Construido a partir de la lista SDN oficial de la OFAC, no un espejo de terceros
- **Coincidencia de nombre y alias**: Un término de búsqueda se compara tanto con el nombre principal como con cada alias registrado - no necesita saber cuál de los dos está en el archivo
- **Filtrado avanzado**: Reduzca por programa de sanciones, país, tipo de entidad o rango de fecha de nacimiento, combinado con su búsqueda por nombre
- **Respuestas muy rápidas**: Procesamiento paralelo (hasta 4 solicitudes simultáneas) para lotes grandes
- **Rentable**: Paga por nombre verificado más una pequeña tarifa por coincidencia: `$0.003 / nombre`, `$0.001 / coincidencia`

### Inicio rápido

1. Abra el actor en Apify y vaya a la pestaña **Input**.
2. Pegue el ejemplo de entrada de abajo (o edite la lista prellenada).
3. Haga clic en **Start** y espere a que termine la ejecución.
4. Abra la pestaña **Output** (dataset) para ver o exportar los resultados como JSON, CSV o Excel.

```json
{
  "names": ["Rosneft"]
}
```

### Ejemplos de uso

#### Verificar un solo nombre

```json
{
  "names": ["Rosneft"]
}
```

#### Verificar varios nombres

```json
{
  "names": ["Rosneft", "Lukashenko", "Bank Markazi"]
}
```

#### Filtrar por programa de sanciones

```json
{
  "names": ["Bank"],
  "program": "IRAN"
}
```

#### Filtrar por país y tipo de entidad

```json
{
  "names": ["Trading"],
  "country": "Russia",
  "entityType": "entity"
}
```

#### Filtrar por rango de fecha de nacimiento

```json
{
  "names": ["Ahmed"],
  "dobFrom": "1970-01-01",
  "dobTo": "1985-12-31"
}
```

### Parámetros de entrada

| Parámetro | Tipo | Requerido | Predeterminado | Descripción |
|-----------|------|-----------|----------------|-------------|
| `names` | array | Sí | - | Lista de nombres a verificar (de 1 a 100 por ejecución, cada uno de hasta 1000 caracteres; más de 100 se rechaza) |
| `program` | string | No | - | Solo devolver coincidencias cuya etiqueta de programa contenga este texto |
| `country` | string | No | - | Solo devolver coincidencias cuyo país de dirección contenga este texto |
| `entityType` | string | No | - | Solo devolver coincidencias de este tipo: `individual`, `entity`, `vessel`, `aircraft` |
| `dobFrom` | string | No | - | Solo devolver personas con fecha de nacimiento igual o posterior a esta fecha (`AAAA-MM-DD`) |
| `dobTo` | string | No | - | Solo devolver personas con fecha de nacimiento igual o anterior a esta fecha (`AAAA-MM-DD`) |
| `limit` | integer | No | 100 | Número máximo de coincidencias a devolver por nombre buscado (1-1000) |

### Detalles del filtrado

- Cada nombre en `names` se compara como una **subcadena sin distinguir mayúsculas/minúsculas** tanto contra la columna `name` como `aliases` - "bank" coincide tanto con "Bank Markazi Jomhouri Islami Iran" como con "First National Bank"
- `program`/`country` también son coincidencias de subcadena; `entityType` es una coincidencia exacta
- Todos los filtros se combinan con **lógica AND**: un filtro `program` o `country` reduce cada búsqueda por nombre, no añade más resultados
- `dobFrom`/`dobTo` comparan fechas normalizadas al formato `AAAA-MM-DD` cuando los datos de origen lo permiten - un puñado de entradas SDN registran solo un año parcial o aproximado y no se ordenan de forma fiable por fecha
- `dobFrom`/`dobTo` deben ser fechas reales en formato `AAAA-MM-DD` (p. ej. `1970-01-01`); de lo contrario la ejecución falla; ambos límites son inclusivos
- `program` y `country` aceptan hasta 1000 caracteres; los valores más largos hacen fallar la ejecución
- Una coincidencia encontrada tanto por `name` como por `aliases`, o encontrada por más de uno de sus nombres de búsqueda, se deduplica automáticamente

### Ejemplo de salida

```json
{
  "id": "OFAC-18299",
  "source_list": "OFAC",
  "source_reference": "18299",
  "name": "ROSNEFT TRADING S.A.",
  "entity_type": "entity",
  "aliases": "",
  "programs": "UKRAINE-EO13662|VENEZUELA-EO13850",
  "countries": "Switzerland",
  "nationalities": "",
  "dates_of_birth": "",
  "place_of_birth": "",
  "addresses": "Rue Place du Lac 2, 1204, Geneva, Switzerland",
  "id_documents": "Tax ID No. CHE-309.842.573|Registration Number CH-660.0.257.011-8|Secondary sanctions risk: Ukraine-/Russia-Related Sanctions Regulations, 31 CFR 589.201 and/or 589.209|Executive Order 13662 Directive Determination - Subject to Directive 2|Executive Order 13662 Directive Determination - Subject to Directive 4|Website www.rosneft.com",
  "listed_on": "",
  "remarks": "",
  "error": null
}
```

### Campos de salida

| Campo | Tipo | Descripción |
|-------|------|-------------|
| `id` | string | ID único de registro (`OFAC-` + uid numérico propio de la OFAC) |
| `source_list` | string | Siempre `"OFAC"` para este actor |
| `source_reference` | string | ID numérico único propio de la OFAC (uid) para esta entrada |
| `name` | string | Nombre principal de la persona o entidad sancionada |
| `entity_type` | string | `individual`, `entity`, `vessel` o `aircraft` |
| `aliases` | string | Alias / apodos conocidos (separados por barras verticales) |
| `programs` | string | Etiquetas de programas de sanciones de la OFAC, por ej. `CUBA`, `SDGT`, `DPRK3` (separadas por barras verticales) |
| `countries` | string | Países asociados a direcciones conocidas (separados por barras verticales) |
| `nationalities` | string | Nacionalidades registradas, solo personas físicas (separadas por barras verticales) |
| `dates_of_birth` | string | Fechas de nacimiento registradas, solo personas físicas, normalizadas al formato `AAAA-MM-DD` cuando sea posible (separadas por barras verticales) |
| `place_of_birth` | string | Lugar(es) de nacimiento registrado(s), solo personas físicas |
| `addresses` | string | Direcciones conocidas (separadas por barras verticales) |
| `id_documents` | string | Documentos/números de identificación registrados (separados por barras verticales) |
| `listed_on` | string | No incluido en la exportación SDN de la OFAC - siempre vacío para este conjunto de datos |
| `remarks` | string | Notas de texto libre (por ej. cargo/puesto), truncadas a 2000 caracteres |
| `error` | null/string | Mensaje de error si la búsqueda falló |

### Plan gratuito

El plan gratuito incluye 5 ejecuciones en total. Cada ejecución gratuita solo procesa los primeros 10 nombres de su entrada (el resto se ignora sin error) y devuelve como máximo 10 resultados.

### Precios

| Evento | Precio | Facturación |
|--------|--------|-------------|
| Inicio del Actor | $0.002 | Una vez por ejecución |
| Nombre verificado | $0.003 | Por cada nombre enviado cuya búsqueda finaliza, con o sin coincidencias |
| Coincidencia devuelta | $0.001 | Por cada entrada de sanciones coincidente devuelta |

Ejemplos de coste (inicio + nombres verificados + coincidencias devueltas):

| Ejecución | Coste |
|-----------|-------|
| 1 nombre, 1 coincidencia | $0.006 |
| 100 nombres, 20 coincidencias en total | $0.322 |

Una ejecución admite hasta 100 nombres. Un nombre sin coincidencias se factura igualmente como nombre verificado (pero no devuelve coincidencias que pagar). Un nombre cuya búsqueda falla no se factura. Si define un coste máximo por ejecución y se alcanza, el Actor se detiene y solo se devuelven los nombres ya verificados.

### Integración de API

#### cURL

```bash
curl -X POST "https://api.apify.com/v2/acts/bite-sized-insights/ofac-sanctions-search-es/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "names": ["Rosneft", "Lukashenko"],
    "entityType": "individual"
  }'
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("bite-sized-insights/ofac-sanctions-search-es").call(
    run_input={
        "names": ["Rosneft", "Lukashenko"]
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} ({item['entity_type']}) - programs: {item['programs']}")
```

#### JavaScript

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

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('bite-sized-insights/ofac-sanctions-search-es').call({
    names: ['Rosneft', 'Lukashenko'],
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.name} (${item.entity_type}) - programs: ${item.programs}`);
});
```

### Casos de uso

- **Verificación KYC/AML**: Verifique clientes, proveedores o contrapartes contra la lista de sanciones de EE. UU. antes de incorporarlos
- **Monitoreo continuo**: Vuelva a ejecutar periódicamente contra su lista de clientes para detectar nuevas designaciones
- **Cumplimiento de transacciones**: Verifique las partes de un pago/transacción antes de procesarlo
- **Investigación de listas de vigilancia**: Consulte entradas SDN conocidas, sus alias y programas asociados

### Preguntas frecuentes

#### ¿Son estos los datos oficiales de la OFAC?

Sí - el conjunto de datos se construye a partir de la lista SDN oficial de la OFAC. Se actualiza semanalmente, no en tiempo real.

#### ¿Realiza coincidencia difusa/fonética de nombres?

La coincidencia se basa en subcadenas sin distinguir mayúsculas/minúsculas contra el nombre y cada alias registrado, no en coincidencia difusa fonética (por ej. Soundex/Levenshtein). Encontrará "Rosneft" dentro de "ROSNEFT TRADING S.A." pero no detectará un error ortográfico como "Rosnaft" a menos que también sea un alias registrado. Para un programa de cumplimiento que requiera coincidencia difusa, ejecute primero la búsqueda por subcadena de este Actor y luego aplique su propia capa de coincidencia difusa sobre el conjunto de resultados (mucho más reducido).

#### ¿Puedo buscar solo entidades, no personas físicas?

Sí - establezca `entityType` en `entity` (o `vessel`/`aircraft`).

#### ¿Y si también necesito las listas de sanciones de la UE o el Reino Unido?

Consulte nuestro Actor [Global Sanctions Search](https://apify.com/bite-sized-insights/global-sanctions-search), que busca en la OFAC junto con las listas consolidadas de la UE y el Reino Unido en una sola llamada.

#### ¿Qué pasa si un nombre no coincide con nada?

No hay error - ese nombre simplemente no aporta ningún registro a la salida. Todos los nombres se verifican de forma independiente en la misma ejecución.

### Descargo de responsabilidad

Este Actor proporciona acceso a datos de sanciones públicamente disponibles del gobierno de EE. UU. (la lista SDN de la OFAC) con fines de verificación e investigación. **No** constituye asesoramiento legal, y su uso **no** garantiza el cumplimiento de la normativa de la OFAC ni de ningún otro régimen de sanciones. La coincidencia se basa en subcadenas, no en una coincidencia difusa/fonética certificada contra la lista SDN, y los datos subyacentes se actualizan semanalmente en lugar de en tiempo real - verifique siempre una posible coincidencia con las propias herramientas oficiales en vivo de la OFAC antes de tomar cualquier medida de cumplimiento. Usted es responsable de su propio programa de cumplimiento de sanciones y de sus requisitos específicos.

### ¿Necesita una cobertura más amplia?

¿Busca algo más que solo la lista de EE. UU.? Consulte nuestro otro Actor:

- [Global Sanctions Search](https://apify.com/bite-sized-insights/global-sanctions-search) - Listas de sanciones OFAC + UE + Reino Unido en una sola búsqueda

***

**¿Necesita ayuda?** Abra un problema en el repositorio del Actor o contacte con soporte a través de Apify Console.

# Actor input Schema

## `names` (type: `array`):

Lista de nombres de personas o entidades a verificar contra la lista SDN de la OFAC. Coincide tanto con los nombres principales como con los alias registrados (coincidencia parcial, sin distinguir mayúsculas/minúsculas).

## `program` (type: `string`):

Solo devolver coincidencias cuyo programa contenga este texto (por ej. "CUBA", "SDGT", "DPRK3").

## `country` (type: `string`):

Solo devolver coincidencias cuyo país de dirección contenga este texto (por ej. "Iran", "Russia"). Los nombres de país están en inglés.

## `entityType` (type: `string`):

Solo devolver coincidencias de este tipo.

## `dobFrom` (type: `string`):

Solo devolver personas cuya fecha de nacimiento registrada sea igual o posterior a esta fecha (AAAA-MM-DD). Mejor esfuerzo: las fechas de nacimiento de la OFAC se normalizan al formato ISO cuando los datos de origen lo permiten, pero algunas entradas registran solo un año parcial o aproximado.

## `dobTo` (type: `string`):

Solo devolver personas cuya fecha de nacimiento registrada sea igual o anterior a esta fecha (AAAA-MM-DD). Misma advertencia de mejor esfuerzo que la fecha de nacimiento desde.

## `limit` (type: `integer`):

Número máximo de coincidencias a devolver por nombre buscado (1-1000).

## Actor input object example

```json
{
  "names": [
    "Rosneft",
    "Lukashenko"
  ],
  "limit": 100
}
```

# Actor output Schema

## `results` (type: `string`):

Entradas SDN de la OFAC coincidentes, incluyendo alias, programas, direcciones y datos de identificación

# 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 = {
    "names": [
        "Rosneft",
        "Lukashenko"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("bite-sized-insights/ofac-sanctions-search-es").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 = { "names": [
        "Rosneft",
        "Lukashenko",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("bite-sized-insights/ofac-sanctions-search-es").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "names": [
    "Rosneft",
    "Lukashenko"
  ]
}' |
apify call bite-sized-insights/ofac-sanctions-search-es --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,bite-sized-insights/ofac-sanctions-search-es"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/E3c4Tc0W9kQ98xfQH/builds/Oe3La8jypBF1XaI2G/openapi.json