Integraciones · API

API de licitaciones del Estado peruano

Licitaciones y contrataciones menores en JSON, con ganador, monto adjudicado y plazos. Solo lectura, autenticación por clave, respuestas en castellano y fechas en ISO 8601 con hora de Lima.

Conseguir una clave

Autenticación

Crea tu clave en Mi cuenta → Integraciones. Se enseña una sola vez: guárdala como un secreto. Mándala en una cabecera, nunca en la URL:

curl https://licitacionesperu.pe/api/v1/licitaciones/?q=uniformes \
  -H "Authorization: Bearer lp_tu_clave"

También se acepta X-API-Key: lp_tu_clave.

Endpoints

Ruta	Qué devuelve
`GET /api/v1/licitaciones/`	Listado de licitaciones, de la más reciente a la más antigua.
`GET /api/v1/licitaciones/{id}/`	Una licitación con ganador, OCID, número de postores y documentos.
`GET /api/v1/contrataciones-menores/`	Contrataciones menores (hasta 8 UIT).
`GET /api/v1/contrataciones-menores/{id}/`	Una contratación menor con sus ítems, proveedor y precio.
`GET /api/v1/entidades/`	Entidades compradoras con su número de procesos. Filtro `q`.
`GET /api/v1/estado/`	Tu plan y tu consumo. No gasta cuota.

Filtros de los listados

Parámetro	Ejemplo	Notas
`q`	`q=mantenimiento de vías`	Búsqueda de texto en la descripción.
`estado`	`estado=CONVOCADO`	Tal como lo publica SEACE (CONVOCADO, ADJUDICADO, CONSENTIDO, CONTRATADO…; en contrataciones menores, Vigente o Culminado).
`objeto`	`objeto=Servicio`	Bien, Servicio, Obra, Consultoría de Obra.
`departamento`	`departamento=Arequipa`	Con o sin tildes.
`entidad`	`entidad=SEGURO SOCIAL DE SALUD`	Nombre exacto de la entidad (ver `/entidades/`).
`monto_min`, `monto_max`	`monto_min=100000`	Valor referencial en soles. Solo licitaciones.
`anio`	`anio=2026`	Año de publicación, dentro de lo que cubre tu plan.
`solo_cotizando`	`solo_cotizando=1`	Contrataciones menores que aún reciben cotizaciones.
`actualizadas_desde`	`actualizadas_desde=2026-10-01T00:00:00-05:00`	Lo que apareció o cambió de estado o ganador después de esa fecha, en orden ascendente. Es la forma de sincronizar: guarda el campo `actualizado` del último resultado y úsalo en la siguiente llamada.
`pagina`, `por_pagina`	`pagina=2&por_pagina=100`	Hasta 100 por página (20 en la demo) y 200 páginas.

Los listados no traen el total de resultados: contarlos en cada página costaría segundos. Traen hay_mas, que dice si hay otra página.

Ejemplo de respuesta

{
  "pagina": 1, "por_pagina": 20, "hay_mas": true, "plan": "pro",
  "resultados": [{
    "id": "a27113e87e95a1ee",
    "nomenclatura": "CP-ABR-186-2026-MDSM/CS-1",
    "titulo": "Servicio de limpieza de locales municipales",
    "entidad": "MUNICIPALIDAD DISTRITAL DE SAN MARTIN DE PORRES",
    "objeto": "Servicio", "departamento": "Lima", "estado": "CONSENTIDO",
    "valor_referencial": 92000.0, "moneda": "PEN",
    "publicado": "2026-09-25T14:20:00-05:00",
    "actualizado": "2026-10-20T07:12:03-05:00",
    "plazos": [{"etapa": "consultas", "nombre": "Consultas y observaciones",
                "fin": "2026-09-30T23:59:00-05:00", "vencido": true}],
    "ganador": {"nombres": ["SERVICIOS GENERALES APO & C S.R.L."], "monto": 87000.0},
    "url": "https://licitacionesperu.pe/licitaciones/a27113e87e95a1ee/"
  }]
}

Los archivos de las bases no se entregan por el API: el detalle lista sus nombres y tipos, y se descargan desde la ficha (url).

Planes y límites

Plan	Precio	Llamadas	Por minuto	Ganador en listados	Archivo
Demo	Gratis con cuenta	100 en total, 7 días	10	No (sí en el detalle)	Año en curso
API PRO	S/ 299 al mes	20 000 al día	120	Sí	Completo
Ilimitado	A medida	100 000 al día	300	Sí	Completo

Para contratar API PRO o Ilimitado escríbenos a hola@loualcala.com con el correo de tu cuenta: activamos el plan en tus claves, sin cambiarlas. API PRO se vende aparte de Licitaciones PRO; la suscripción del sitio no incluye el API.

Errores

Código	`error`	Qué hacer
401	`falta_clave`	Manda la cabecera `Authorization`.
403	`clave_invalida`, `fuera_del_plan`	Revisa la clave, o pide un año que cubra tu plan.
402	`demo_agotada`, `demo_caducada`	La demo terminó: pasa a API PRO.
429	`cuota_agotada`	Espera los segundos de la cabecera `Retry-After`.

Cada respuesta trae las cabeceras X-Plan, X-RateLimit-Limit y X-RateLimit-Remaining.