API pública · v1
El mismo catálogo que ves en el sitio, listo para tu sistema. Se actualiza varias veces al día desde Talento Perú y trae algo que el portal oficial no da: las bases en PDF que cada entidad publica en su propia web, y el archivo de lo que ya cerró.
El dato es público y el sitio es gratis. Las entidades están obligadas a publicarlo por el D.S. 003-2018-TR, puedes consultarlo en el portal de SERVIR y puedes navegarlo acá sin pagar nada, siempre. Lo que se cobra es el trabajo: recogerlo varias veces al día de un portal que no guarda archivo, normalizarlo, seguir el enlace de cada entidad para cosechar las bases y servirlo listo para tu sistema.
Tres pasos y la primera llamada.
curl https://convocatoriasestado.pe/api/v1/convocatorias/?carrera=enfermeria \
-H "Authorization: Bearer cep_tu_clave_aqui"
También se acepta X-API-Key: cep_.... Lo que no se acepta
es la clave en la querystring: acabaría en los registros del servidor
y en el historial del navegador.
| Método y ruta | Qué devuelve |
|---|---|
GET /api/v1/convocatorias/ | Listado con filtros y paginación. |
GET /api/v1/convocatorias/{id}/ | Una convocatoria con todos los campos de ficha y sus documentos. |
GET /api/v1/entidades/ | Entidades con convocatorias. |
GET /api/v1/carreras/ | El vocabulario de carreras que acepta el filtro. |
GET /api/v1/departamentos/ | Departamentos con convocatorias abiertas. |
GET /api/v1/estado/ | Tu cuota. No descuenta del límite diario. |
/convocatorias/| Parámetro | Ejemplo | Qué hace |
|---|---|---|
carrera | enfermeria | Vocabulario cerrado. Consúltalo en /carreras/. |
departamento | LIMA | Como lo escribe el portal, en mayúsculas. |
categoria | ofertas_laborales | O modalidades_formativas para prácticas. |
entidad | poder-judicial | El slug que devuelve /entidades/. |
q | enfermera, tecnico | Texto libre. Las comas son alternativas. |
sueldo_min | 2500 | Remuneración mínima en soles. |
con_bases | false | Por defecto sólo salen las que tienen bases (o perfil del puesto) publicadas. Con false salen todas. |
con_documentos | true | Sólo las que tienen algún documento cosechado, sea cual sea. |
fuente | servir | De dónde salió la convocatoria: servir (Talento Perú) o entidad (su web). |
publicadas_desde | 2026-08-01 | Para sincronizar sin rebajarte el catálogo entero. |
vigentes | false | Abre el archivo histórico. |
pagina · por_pagina | 2 · 100 | Máximo 100 por página (10 en la demo). |
{
"total": 153,
"pagina": 1,
"paginas": 4,
"por_pagina": 50,
"resultados": [
{
"id": 7363,
"puesto": "TRABAJADORA SOCIAL",
"entidad": "HOSPITAL NAC DOCENTE M YN SAN BARTOLOME",
"numero_convocatoria": "276-002",
"departamento": "LIMA",
"vacantes": 1,
"remuneracion": 5300.0,
"moneda": "PEN",
"fecha_inicio": "2026-08-21",
"fecha_fin": "2026-09-03",
"fechas": {
"servir": {"inicio": "2026-08-21", "fin": "2026-09-03"},
"bases": {"inicio": "2026-09-04", "fin": "2026-09-05",
"documento": "BASES CAS 002-2026"},
"coinciden": false
},
"vigente": true,
"fuente": "servir",
"tiene_bases": true,
"entidad_logo": "https://convocatoriasestado.pe/media/logos/...png",
"entidad_logo_tipo": "oficial",
"url": "/convocatoria/7363-trabajadora-social/",
"enlace_entidad": "https://sanbartolome.gob.pe/..."
}
]
}
El detalle de una convocatoria añade los requisitos y la lista de
documentos. Cada documento trae el enlace
que publica la entidad, su tipo, tamaño y hash de contenido, para
detectar cuándo cambia. Si guardamos copia, trae además
archivo: un enlace a nuestra copia que caduca en una
hora. Sigue sirviendo aunque la entidad haya quitado el documento de
su web.
Hay dos cronogramas, y se dan por separado porque no siempre
coinciden. cronograma es el que la entidad registró en
Talento Perú, que suele ser la ventana de difusión.
cronograma_bases lo leemos de las bases que la entidad
publicó en su web, con cada etapa (postulación, evaluación,
entrevista, resultados) y el documento del que sale. Cuando las
fechas no cuadran, la diferencia es justo lo que hay que revisar.
fechas resume lo mismo para la postulación, en el
listado y en el detalle: la ventana de Talento Perú
(servir), la de las bases (bases) y si
cierran el mismo día (coinciden). Discrepan a menudo:
en octubre de 2026, de las plazas abiertas cuyas bases traen la
postulación, sólo una de cada diez cerraba el mismo día. Cuando
discrepan, manda la de las bases, que es el documento del concurso.
bases y coinciden son null
si no pudimos leer un cronograma de esa plaza.
entidad_logo siempre trae una imagen. Si
entidad_logo_tipo es oficial, es el logo
de la entidad (de su página en gob.pe o de su web); si es
monograma, no hay uno que podamos atribuir con
seguridad y es un SVG con sus iniciales. /entidades/
trae lo mismo en logo y logo_tipo.
Cada clave tiene una cuota por día y otra por minuto. La respuesta
trae siempre X-RateLimit-Limit y
X-RateLimit-Remaining, y al pasarte devuelve
429 con Retry-After en segundos.
Base
S/ 299 al mes
Estándar
S/ 599 al mes
Profesional
S/ 1,200 al mes
Se paga con tarjeta y se renueva solo cada 30 días. Lo cancelas cuando quieras desde tu panel y conservas el plan hasta el final del mes pagado. Si necesitas factura, déjanos tu RUC al contratar.
Demo
Para evaluar
Alcanza para escribir tu integración y ver si el dato te sirve, no para llevarte el catálogo.
| Código | Cuándo |
|---|---|
401 falta_clave | No mandaste cabecera de autenticación. |
403 clave_invalida | La clave no existe o está desactivada. |
404 no_encontrada | Ese id no existe. |
400 carrera_desconocida | Un filtro con vocabulario cerrado trae un valor que no existe. |
429 cuota_agotada | Te pasaste del límite. Mira Retry-After. |
402 demo_agotada | Gastaste las llamadas de la demo. Es 402 y no 403 porque la clave está bien: lo que falta es contratar. |
402 demo_caducada | Pasaron los 14 días. |