OSIPTEL Consulta de Líneas Telefónicas

📞 Consulta de Líneas Telefónicas por RUC (fuente OSIPTEL) — Perú

Herramienta independiente no afiliada ni respaldada por OSIPTEL. Consulta datos públicos de OSIPTEL.

Consulta todas las líneas telefónicas registradas a un RUC peruano en el padrón público de OSIPTEL: índice de línea, modalidad (postpago/prepago/control), número de servicio (enmascarado) y operador — para uno o varios RUCs por ejecución.

Ejemplo de salida (un registro por línea)

{
  "ruc": "20100047218",
  "indice": "1",
  "modalidad": "POSTPAGO",
  "numeroServicio": "99998****",
  "operador": "TELEFONICA DEL PERU S.A.A.",
  "scrapedAt": "2026-07-29T18:54:25Z"
}

Un RUC sin líneas registradas igual genera un registro, con indice/modalidad/numeroServicio/operador en null — así un resultado vacío se lee como "consultado, no se encontró nada", no como un registro perdido.

Pruébalo: input y API

Input (pestaña Input en la Consola, o vía API):

{
  "rucs": ["20432405525", "20100047218"]
}

Ejecutar de forma asíncrona (recomendado en general, ya que la ejecución solo termina cuando se consultó cada RUC — no conviene mantener la conexión abierta esperando, sobre todo con lotes grandes):

# 1. Inicia la ejecución (devuelve de inmediato, con el run en estado RUNNING)
curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~osiptel-scraper-client/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rucs":["20100047218"]}'
# -> devuelve { "data": { "id": "RUN_ID", "defaultDatasetId": "DATASET_ID", "status": "RUNNING", ... } }

# 2. Consulta el estado del run hasta que sea SUCCEEDED (por polling o webhook)
curl "https://api.apify.com/v2/actor-runs/RUN_ID?token=YOUR_APIFY_TOKEN"

# 3. Una vez terminado, obtén los resultados del dataset
curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_APIFY_TOKEN"

Ejecutar de forma sincrónica (más simple, pero solo recomendado para lotes pequeños de RUCs — la conexión queda abierta hasta que termina la consulta):

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~osiptel-scraper-client/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"rucs":["20100047218"]}'

Exporta el dataset como JSON, CSV o XLSX desde la Consola.

Mientras la consulta sigue corriendo en segundo plano, el dataset puede ir creciendo en bloques durante la ejecución a medida que van apareciendo resultados nuevos; no hace falta esperar siempre hasta el final para empezar a ver filas.

Opcional: reutilizar datos recientes

Por defecto, cada RUC se consulta de nuevo en cada ejecución. Si prefieres reutilizar un resultado reciente en vez de volver a consultar, agrega useHistoricDataWithinHours al input:

{
  "rucs": ["20432405525", "20100047218"],
  "useHistoricDataWithinHours": 24
}

Con 24, cualquier RUC ya consultado exitosamente en algún momento de las últimas 24 horas no se vuelve a consultar — se devuelve su resultado existente.

Cobro

Este Actor está pensado para cobrarse por RUC procesado. La referencia comercial es USD 150 por cada 10,000 RUCs.

Cada RUC incluye hasta 5,000 líneas telefónicas devueltas. Si un RUC supera ese volumen, se aplica un cargo adicional por cada bloque extra de 5,000 líneas.

Esto existe porque los RUCs muy grandes requieren procesamiento adicional y generan resultados mucho más pesados que un RUC normal. Para el cliente, lo importante es simple: los RUCs normales pagan la tarifa base; los RUCs excepcionalmente grandes pagan más.

Qué devuelve este Actor

🔑 RUC	ruc
📇 Detalle de línea	indice, modalidad, numeroServicio, operador
🕒 Fecha de consulta	scrapedAt

¿Por qué consultar líneas telefónicas registradas en OSIPTEL?

• Debida diligencia: verificar las líneas de contacto declaradas por una empresa antes de una operación
• Verificación / cumplimiento: cruzar un número registrado con a quién está realmente asignado
• Estudio de mercado: ver qué operador(es) usa una empresa
• Enriquecimiento masivo: agregar datos de líneas telefónicas a una lista de RUCs existente, a escala

Opciones de input

Campo	Obligatorio	Descripción
rucs	Sí	Arreglo de números de RUC peruanos (11 dígitos)
useHistoricDataWithinHours	No	Si un RUC ya fue consultado exitosamente dentro de las últimas N horas, se reutiliza ese resultado en lugar de volver a consultarlo

Límites

• Cada ejecución espera a que se consulte cada RUC solicitado antes de devolver resultados — normalmente unos segundos por RUC. Lotes muy grandes (miles de RUCs a la vez) pueden tardar más.
• Los datos provienen directamente del padrón oficial de OSIPTEL al momento de la consulta (salvo que useHistoricDataWithinHours haya reutilizado un resultado reciente).

Preguntas frecuentes

¿Qué pasa si un RUC no existe o no tiene líneas registradas? Igual se genera un registro para él, con todos los campos de línea en null — es un resultado vacío confirmado, no un error.

¿Qué hace exactamente useHistoricDataWithinHours? Mira hacia atrás desde el momento actual. Si lo configuras en 24, cualquier RUC ya consultado exitosamente en algún momento de las últimas 24 horas no se vuelve a consultar — se reutiliza su resultado existente. Si se omite, todos los RUCs se consultan siempre de nuevo.

¿Qué formato de RUC se espera? El RUC peruano estándar de 11 dígitos (por ejemplo, 20100047218).

¿Puedo enviar miles de RUCs a la vez? Sí, pero la ejecución del Actor tomará más tiempo — solo termina cuando se consultó cada RUC. Para necesidades de volumen muy grande y recurrente, contáctanos directamente.