Rutificador Chile API - Buscar RUT por Nombre

Rutificador Chile API para buscar RUT por nombre

Este Rutificador Chile API permite buscar un RUT chileno por nombre o encontrar un nombre por RUT usando el flujo publico de Nombre Rut y Firma. Entrega resultados estructurados en Apify Dataset, JSON, CSV, Excel, XML y API para consultas puntuales, controladas y auditables.

Integra una consulta RUT de Chile en procesos autorizados sin copiar manualmente tablas del sitio. El Actor normaliza formatos comunes, conserva un estado por consulta y oculta sexo y direccion por defecto para reducir la exposición innecesaria de datos personales.

El Actor consulta nombrerutyfirma.com en tiempo real, normaliza formatos comunes de RUT, usa Apify Residential Proxy en Chile por defecto y guarda una fila auditable por cada consulta valida, incluso cuando no hay resultados. Los campos de sexo y direccion quedan ocultos por defecto.

Para que sirve este Actor

Este Rutificador Chile API ayuda a convertir busquedas manuales de Nombre Rut y Firma en una salida estructurada y facil de integrar. Puede usarse para:

• Buscar RUT por nombre y apellido.
• Buscar nombre por RUT chileno.
• Procesar lotes controlados de hasta 25 consultas por run.
• Normalizar RUTs escritos con puntos, sin puntos, con guion o en formato compacto.
• Revisar resultados en Dataset, JSON, CSV, Excel o por Apify API.
• Auditar resultados con success o no_results; los errores failed quedan en OUTPUT.

No es una API oficial del Gobierno de Chile. Es un Actor de Apify que estructura el flujo publico de nombrerutyfirma.com.

Casos de uso

Caso de uso	Como ayuda
Normalizacion de RUT	Normaliza RUTs escritos en distintos formatos antes de una consulta autorizada.
Verificacion puntual	Confirma si un RUT o nombre tiene coincidencias en la fuente consultada.
Procesos internos autorizados	Integra consultas acotadas cuando existe una finalidad legitima y autorizada.
Lotes controlados	Procesa hasta 25 consultas con estado por fila y salida descargable.
Automatizacion via API	Ejecuta busquedas desde Python, cURL, Make, Zapier, n8n o pipelines propios.

Que datos entrega

Cada fila del dataset puede incluir:

Campo	Descripcion
search_type	Tipo de busqueda: rut o nombre.
query_index	Posicion de la consulta dentro del lote.
status	Estado de la fila del Dataset: success o no_results. Los errores failed quedan solo en OUTPUT.
search_term	RUT normalizado o nombre consultado.
total_results	Cantidad de filas encontradas para esa consulta.
name	Nombre encontrado en la fuente.
rut	RUT encontrado en la fuente.
sex	Sexo reportado por la fuente solo con includeSensitiveFields: true; null por defecto.
address	Direccion solo con includeSensitiveFields: true; null por defecto.
city	Ciudad o comuna cuando la fuente la entrega.
source	URL consultada.
scraped_at	Fecha y hora de extraccion.
error	Detalle del error cuando una consulta falla.

Ejemplo de fila con resultado:

{
  "query_index": 0,
  "status": "success",
  "error": null,
  "search_type": "rut",
  "search_term": "<RUT_CHILENO>",
  "total_results": 1,
  "name": "<NOMBRE_APELLIDO>",
  "rut": "<RUT_CHILENO>",
  "sex": null,
  "address": null,
  "city": "No Disponible",
  "source": "https://www.nombrerutyfirma.com/rut_ext?term=%3CRUT_CHILENO%3E",
  "scraped_at": "2026-05-10T16:36:21"
}

Si una consulta valida no tiene coincidencias, el Actor no deja el dataset vacio. Guarda una fila operativa:

{
  "query_index": 0,
  "status": "no_results",
  "error": null,
  "search_type": "nombre",
  "search_term": "<NOMBRE_APELLIDO>",
  "total_results": 0,
  "name": null,
  "rut": null,
  "sex": null,
  "address": null,
  "city": null
}

Inicio rapido

1. Abre el Actor en Apify.
2. Haz clic en Try for free o Run.
3. Agrega una o varias consultas en queries.
4. Ejecuta el Actor.
5. Descarga los resultados desde Dataset en JSON, CSV, Excel o XML.

Buscar nombre por RUT:

{
  "queries": [
    {
      "searchType": "rut",
      "term": "<RUT_CHILENO>"
    }
  ]
}

Buscar RUT por nombre:

{
  "queries": [
    {
      "searchType": "nombre",
      "term": "<NOMBRE_APELLIDO>"
    }
  ]
}

Lote controlado:

{
  "queries": [
    {
      "searchType": "rut",
      "term": "<RUT_CHILENO>"
    },
    {
      "searchType": "nombre",
      "term": "<NOMBRE_APELLIDO>"
    }
  ],
  "allowPartialResults": false,
  "includeSensitiveFields": false,
  "proxyAttempts": 5,
  "maxConcurrency": 1
}

Formatos de RUT aceptados

Los usuarios suelen pegar RUTs con distintos formatos. El Actor normaliza variantes comunes antes de consultar:

Entrada del usuario	Consulta normalizada
<RUT_CHILENO>	<RUT_CHILENO>
<RUT_SIN_PUNTOS>	<RUT_CHILENO>
<RUT_COMPACTO>	<RUT_CHILENO>
<RUT_CON_ESPACIOS>	<RUT_CHILENO>
RUT <RUT_CHILENO>	<RUT_CHILENO>
<RUT_SIN_DV>	<RUT_CHILENO> cuando el digito verificador se puede calcular

Si el usuario ingresa un digito verificador explicitamente invalido, esa consulta se marca como failed con un mensaje claro. Si allowPartialResults esta activo, el resto del lote continua.

Input

Campo	Tipo	Requerido	Descripcion
queries	array	si	Lista de 1 a 25 consultas. Cada item debe incluir searchType y term.
queries[].searchType	string	si	Usa rut para buscar nombre por RUT o nombre para buscar RUT por nombre. Por API tambien se acepta name como alias de nombre.
queries[].term	string	si	RUT o nombre a consultar. Ejemplos aceptados como placeholders: <RUT_CHILENO>, <RUT_SIN_PUNTOS>, <RUT_COMPACTO>, <RUT_SIN_DV>.
timeoutSecs	integer	no	Segundos maximos para esperar cada pagina del origen. Default: 30.
proxyAttempts	integer	no	Cantidad de sesiones nuevas de proxy residencial chileno a probar por consulta. Default: 5.
maxConcurrency	integer	no	Maximo de consultas en paralelo dentro del mismo run. Default: 1, maximo: 5.
allowPartialResults	boolean	no	Si es true, las consultas fallidas quedan en OUTPUT y el lote continua. Default: false.
includeSensitiveFields	boolean	no	Incluye sexo y direccion solo cuando existe una finalidad legitima y autorizada. Default: false.
proxyConfiguration	object	no	Opcional. El Actor usa Apify Residential Proxy en Chile automaticamente salvo que entregues proxyUrls custom.
debugVisible	boolean	no	Solo para desarrollo local. Debe permanecer desactivado en Apify Cloud.

Ejecutar desde la API de Apify

Python

from apify_client import ApifyClient

client = ApifyClient("<APIFY_API_TOKEN>")

run = client.actor("scraperschile/rutificador").call(
    run_input={
        "queries": [
            {"searchType": "rut", "term": "<RUT_CHILENO>"},
            {"searchType": "nombre", "term": "<NOMBRE_APELLIDO>"},
        ],
        "allowPartialResults": True,
        "maxConcurrency": 3,
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

cURL

curl -X POST \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <APIFY_API_TOKEN>' \
  -d '{
    "queries": [
      { "searchType": "rut", "term": "<RUT_CHILENO>" },
      { "searchType": "nombre", "term": "<NOMBRE_APELLIDO>" }
    ],
    "allowPartialResults": true,
    "maxConcurrency": 3
  }' \
  'https://api.apify.com/v2/acts/scraperschile~rutificador/runs?waitForFinish=60'

Confiabilidad y rendimiento

El Actor consulta una fuente publica en tiempo real. La cobertura, frescura, direcciones disponibles, tiempos de respuesta y tasa de exito dependen del sitio origen.

Para operar mejor en produccion, incluye:

• Apify Residential Proxy en Chile por defecto.
• Rotacion de proxy por consulta y por reintento con proxyAttempts.
• Ruta HTTP liviana primero y fallback con navegador cuando hace falta.
• Playwright headless como fallback para flujos bloqueados o incompletos.
• Bloqueo de recursos pesados del navegador como imagenes, fuentes, estilos y media.
• Concurrencia controlada con maxConcurrency.
• Modo opcional de resultados parciales para lotes.
• Estados explicitos para cada consulta.
• El run falla si todas las consultas fallan; las filas failed no se guardan ni cobran en el Dataset.

El Actor no mantiene un indice privado, no hace sincronizacion en segundo plano y no envia emails por registros faltantes.

Detalles tecnicos

• Construido con Apify Python SDK.
• Usa Playwright cuando la fuente requiere navegador.
• Parsea la tabla de resultados de nombrerutyfirma.com.
• Normaliza RUTs a formato chileno con puntos y digito verificador cuando es posible.
• Guarda resultados validos y consultas sin coincidencias en el dataset por defecto.
• Guarda un registro OUTPUT con el estado del run y oculta sexo y direccion salvo solicitud expresa.
• Esta pensado para API, exportaciones CSV/JSON y consultas controladas.

Pricing

El Actor usa pago por evento: cada fila guardada en el Dataset cuesta USD 0.003 y cada ejecución agrega un evento inicial de USD 0.00005. El Actor escribe filas cobrables para success y no_results; las consultas failed quedan en OUTPUT y no generan filas de Dataset. Revisa la pestaña Pricing de Apify antes de ejecutar, porque es la referencia comercial vigente.

Notas sobre la fuente

Este Actor estructura el flujo publico de nombrerutyfirma.com en Dataset, JSON, CSV, Excel y API de Apify. Es una herramienta no oficial e independiente. No está afiliado, patrocinado ni respaldado por Nombre Rut y Firma, nombrerutyfirma.com ni el Gobierno de Chile.

Uso responsable, privacidad y retencion

Los RUT, nombres y domicilios son datos personales. Usa este Actor solo con una finalidad legitima, informada y autorizada, limita cada consulta a lo necesario y no lo uses para acoso, discriminacion, marketing no solicitado, vigilancia ni decisiones automatizadas sobre personas.

• includeSensitiveFields permanece desactivado por defecto; activarlo es una decision expresa del usuario.
• El Actor no mantiene un indice propio ni una cache paralela. Los resultados quedan en el almacenamiento de la cuenta Apify que ejecuto el run y deben eliminarse cuando dejen de ser necesarios.
• La fuente dispone de un formulario de eliminacion en https://salir.nombrerutyfirma.com/ y publica su politica en https://www.nombrerutyfirma.com/articulos/privacidad.html.
• El usuario es responsable de respetar las condiciones de la fuente, las reglas de Apify y la normativa aplicable en Chile.

Preguntas frecuentes

Puedo buscar RUT por nombre?

Si. Usa searchType: "nombre" y entrega el nombre en term. El Actor devuelve coincidencias posibles desde la fuente, incluyendo RUT y metadata disponible.

Puedo buscar nombre por RUT?

Si. Usa searchType: "rut" y entrega el RUT chileno en term. El Actor acepta formatos comunes con o sin puntos y con o sin guion.

El dataset queda vacio si no hay resultados?

No. Una busqueda valida sin coincidencias guarda una fila con status: "no_results", total_results: 0 y campos de resultado en null.

Soporta lotes?

Si, hasta 25 consultas por run. Cada consulta mantiene su propio query_index, status, error y conteo de resultados.

Que pasa si una consulta falla dentro de un lote?

Con allowPartialResults: true, la consulta fallida queda en OUTPUT y el resto del lote continua. No se guarda ni cobra como fila del Dataset. Si todas fallan, el run termina como fallido.

Usa proxy automaticamente?

Si. Por defecto usa Apify Residential Proxy en Chile y rota sesiones por consulta/reintento. El usuario no necesita configurarlo manualmente salvo que quiera usar proxyUrls propios.

Es una API oficial del Gobierno de Chile?

No. Es un Actor de Apify que estructura resultados del flujo publico de nombrerutyfirma.com.

Puedo integrarlo desde un sistema documentado en ingles?

Si. La API usa JSON y nombres de campo estables, por lo que puede integrarse desde clientes en español o ingles. La finalidad legitima, la minimizacion de datos y las demas obligaciones de uso responsable no cambian según el idioma del sistema.