Colombia SECOP II - Licitaciones y Contratación Pública Scraper

Extrae procesos contractuales y licitaciones públicas abiertas de Colombia desde la API oficial de Datos Abiertos (SECOP II), de forma rápida, estructurada y sin bloqueos.

A diferencia de otros scrapers que usan navegadores headless y lidian con CAPTCHAs, este Actor consulta directamente la API REST de Socrata (p6dx-8zbt), lo que resulta en tiempos de respuesta de menos de 2 segundos por corrida.

---

Características principales

• Filtros avanzados por SoQL: palabras clave, entidad, NIT, departamento, estado, fase, modalidad y tipo de contrato.
• Filtrado financiero y temporal: rangos de cuantía (precio_base), fechas de publicación y paginación automática.
• Rápido y liviano: consulta directa a la API de Datos Abiertos. Sin navegadores, sin CAPTCHA, sin consumo innecesario de RAM.
• Datos normalizados: montos numéricos, fechas en formato YYYY-MM-DD, y enlaces directos a cada proceso en SECOP II.

---

Casos de uso

• Empresas y contratistas que necesitan detectar oportunidades de licitación a tiempo.
• Firmas de ingeniería, consultoría y proveedores del Estado que monitorean sectores específicos.
• Analistas que rastrean la contratación pública por región, entidad o presupuesto.
• Integradores que alimentan CRMs o tableros con oportunidades activas.

---

Parámetros de Entrada (Input)

Campo	Tipo	Descripción	Ejemplo
keywords	Array	Palabras clave en el nombre o descripción del proceso	["software", "computadores"]
entidad	String	Nombre parcial o NIT de la entidad pública	"Alcaldía" o "899999027"
departamento	String	Departamento de la entidad contratante	"Antioquia"
estado	String	Estado del procedimiento. Valores válidos: Abierto, Aprobado, Borrador, Cancelado, En aprobación, Evaluación, Publicado, Seleccionado, Suspendido	"Publicado"
fase	String	Fase actual del procedimiento	"Presentación de oferta"
modalidad	String	Modalidad de contratación	"Licitación pública"
tipo_de_contrato	String	Tipo de contrato	"Prestación de servicios"
precio_min	Integer	Presupuesto mínimo en COP	10000000
precio_max	Integer	Presupuesto máximo en COP	500000000
fecha_desde	String	Fecha mínima de publicación (YYYY-MM-DD)	"2026-01-01"
fecha_hasta	String	Fecha máxima de publicación (YYYY-MM-DD)	"2026-12-31"
maxItems	Integer	Límite de procesos a extraer (default: 100, máx: 10000)	500
appToken	String	Socrata App Token opcional para mitigar rate limits	"abc123..."

---

Datos de Salida (Output)

Cada resultado guardado en el Dataset contiene 25 campos normalizados:

{
  "id_proceso": "CO1.REQ.10564862",
  "referencia": "RE-005-2026",
  "entidad": "INSTITUCION EDUCATIVA DE LA VENTURA",
  "nit_entidad": "806014617",
  "departamento": "Bolívar",
  "ciudad": "Tiquisio",
  "orden_entidad": "Territorial",
  "nombre_procedimiento": "LICENCIA DE USO SOFTWARE CONTABLE...",
  "descripcion": "LICENCIA DE USO SOFTWARE CONTABLE, FINANCIERO Y PRESUPUESTAL...",
  "fase": "Presentación de oferta",
  "estado": "Publicado",
  "precio_base": 3000000.0,
  "modalidad": "Contratación régimen especial",
  "tipo_contrato": "Compraventa",
  "duracion": 8,
  "unidad_duracion": "Mes(es)",
  "fecha_publicacion": "2026-09-16",
  "fecha_ultima_actualizacion": "2026-09-16",
  "id_portafolio": "CO1.BDOS.10383757",
  "categoria_unspsc": "V1.81112501",
  "estado_apertura": "Abierto",
  "adjudicado": "No",
  "nombre_proveedor": "No Definido",
  "valor_adjudicado": "0",
  "codigo_entidad": "718955438",
  "url_secop": "https://community.secop.gov.co/Public/Tendering/OpportunityDetail/Index?noticeUID=CO1.NTC.10906260"
}

Ejemplo de uso

Extraer las licitaciones abiertas de software publicadas en 2026 con presupuesto mayor a 50 millones de COP:

{
  "keywords": ["software"],
  "estado": "Publicado",
  "precio_min": 50000000,
  "fecha_desde": "2026-01-01",
  "maxItems": 100
}

Fuente de datos

Datos Abiertos Colombia - Procesos de Contratación (SECOP II) Dataset: p6dx-8zbt Endpoint: https://www.datos.gov.co/resource/p6dx-8zbt.json