Datos abiertos
Toda la información de este portal está disponible en ficheros JSON para su reutilización en webs, aplicaciones o análisis. No se requiere clave ni registro, y los ficheros pueden leerse desde cualquier web (CORS abierto). Se generan de nuevo con cada actualización del portal, aproximadamente cada hora.
Ficheros
- ofertas.json: todas las ofertas, abiertas y cerradas.
- procesos.json: los procesos selectivos y sus comunicados, por fases.
- novedades.json: las ofertas y los comunicados nuevos de los últimos 14 días. Es el fichero más adecuado para crear avisos propios.
- listas.json: el nombre de cada clave que usan los demás ficheros (comunidades autónomas, organismos, áreas, tipos de contrato…).
Las listas RSS de avisos también pueden reutilizarse.
Ejemplos
En macOS (15 o posterior) y en muchas distribuciones de Linux, curl y jq vienen instalados; si falta jq, puede instalarse con el gestor de paquetes. En Windows, PowerShell no necesita nada más.
Ofertas abiertas en Andalucía
Con el código del INE de la comunidad autónoma (01), y su título, empresa, fin del plazo y enlace:
macOS y Linux (Terminal)
curl -s https://alertapublica.es/api/ofertas.json | jq '.ofertas[] | select(.estado == "abierta" and .ccaa == "01") | {titulo, empresa, plazo_fin, url}'Windows (PowerShell)
(Invoke-RestMethod https://alertapublica.es/api/ofertas.json).ofertas |
Where-Object { $_.estado -eq "abierta" -and $_.ccaa -eq "01" } |
Select-Object titulo, empresa, plazo_fin, urlJavaScript (navegador)
const datos = await (await fetch("https://alertapublica.es/api/ofertas.json")).json();
const abiertas = datos.ofertas.filter(o => o.estado === "abierta" && o.ccaa === "01");Novedades de ofertas en Galicia
Con el código del INE 12, y su título y su enlace:
macOS y Linux (Terminal)
curl -s https://alertapublica.es/api/novedades.json | jq '.novedades[] | select(.tipo == "oferta" and .ccaa == "12") | {titulo, url}'Windows (PowerShell)
(Invoke-RestMethod https://alertapublica.es/api/novedades.json).novedades |
Where-Object { $_.tipo -eq "oferta" -and $_.ccaa -eq "12" } |
Select-Object titulo, urlJavaScript (navegador)
const datos = await (await fetch("https://alertapublica.es/api/novedades.json")).json();
const galicia = datos.novedades.filter(n => n.tipo === "oferta" && n.ccaa === "12");Campos de cada fichero
Formato común
Todos los ficheros comienzan con estos campos:
| Campo | Descripción |
|---|---|
version | Versión del formato (actualmente, 1). Dentro de una versión solo se añaden campos; renombrar o quitar uno obliga a cambiarla. |
licencia | Licencia de reutilización. |
documentacion | Enlace a esta página. |
generado | Momento de generación del fichero (ISO 8601). |
Un dato que la fuente no facilita vale null. Los textos de ofertas y comunicados se reproducen tal como los publica cada organismo.
Ofertas (ofertas.json)
El campo ofertas contiene todas las ofertas guardadas desde el inicio del portal, abiertas y cerradas, con estos campos:
| Campo | Descripción |
|---|---|
id | Identificador estable: la clave del organismo, dos puntos y el identificador interno de la oferta en su portal. |
organismo | Clave del organismo (organismos en listas.json). |
codigo | Código o referencia que el portal publica con la oferta; null si no publica ninguno. |
titulotitulo_original | Título sin el código interno que algunos portales añaden, y título literal del portal. |
empresa | Empresa o entidad que contrata. |
estado | abierta o cerrada, según las fechas del plazo y no según la etiqueta de la web. |
ubicacionlocalidadcomunidad | Ubicación literal, localidad deducida del título o de la ficha, y nombre de la comunidad autónoma. |
ccaaprovinciamunicipio | Códigos del INE de comunidad autónoma, provincia y municipio. Solo se asignan cuando el texto no deja dudas: «Sevilla» puede ser la provincia o la capital, y se queda en provincia. |
plazas | Número de plazas. |
tipo_contratocontrato | Tipo de contrato (tipos_contrato en listas.json), solo si la fuente lo indica con claridad, y texto literal del contrato. |
convocatoriatipo_puestodepartamento | Datos que la fuente publica con esas denominaciones, si los publica. |
plazo_inicioplazo_finplazo_hora | Fechas de inicio y fin del plazo (AAAA-MM-DD) y hora de cierre (HH:MM, hora peninsular). Sin hora, el último día cuenta completo. |
publicada | Fecha de publicación según la fuente. |
detectadacerrada | Momentos (ISO 8601) en que este portal detectó la oferta y en que se cerró. |
republica | Código de la oferta anterior, si es una nueva publicación de aquella. |
areas | Áreas profesionales (areas en listas.json). Clasificación orientativa que asigna este portal; puede haber varias o ninguna. |
teletrabajo | Frase literal de la ficha que menciona el teletrabajo; false si la ficha tiene texto y no lo menciona; null si no puede saberse porque la ficha solo remite a las bases. |
urlurl_inscripcionurl_portal | Enlaces a la ficha oficial, a la inscripción oficial y a la ficha en este portal. |
Procesos (procesos.json)
El campo procesos contiene los procesos selectivos, con los datos de su comunicado más reciente:
| Campo | Descripción |
|---|---|
id | Identificador estable del proceso. |
organismo | Clave del organismo (organismos en listas.json). |
nombre | Nombre literal del proceso. |
tipoaccesotipo_contratosistema | Tipo de proceso, tipo de acceso, tipo de contrato y sistema de selección (tipos_proceso, accesos, tipos_contrato y sistemas en listas.json), si constan. |
estado | Situación del proceso (estados_proceso en listas.json). |
plazo_finplazo_horaurl_inscripcion | Fin del plazo, hora de cierre y enlace de inscripción, solo mientras la inscripción está abierta. |
url | Página o documento oficial del proceso. |
comunicados | Comunicados del proceso, del más reciente al más antiguo, con fecha (AAAA-MM-DD o null), titulo y url. No incluye relaciones de personas. |
Novedades (novedades.json)
El campo dias indica el periodo que abarca el fichero (14 días), y novedades contiene, de la más reciente a la más antigua, las ofertas nuevas o publicadas de nuevo que siguen abiertas y los comunicados nuevos de los procesos:
| Campo | Descripción |
|---|---|
id | Identificador estable: la misma novedad conserva siempre el mismo id, de modo que puede avisarse una sola vez. |
fecha | Momento (ISO 8601) en que este portal detectó la novedad. |
tipo | oferta o comunicado. |
evento | Solo ofertas: new (nueva) o republished (nueva publicación). |
organismo | Clave del organismo (organismos en listas.json). |
ccaaareasteletrabajo | Solo ofertas: como en ofertas.json. |
proceso | Solo comunicados: nombre del proceso. |
titulo | Título de la oferta o del comunicado. |
detalle | Solo ofertas: resumen en una línea con la empresa, la ubicación, las plazas y el plazo. |
url | Ofertas: ficha en este portal. Comunicados: documento oficial. |
Listas (listas.json)
Relaciona cada clave con su nombre:
| Campo | Descripción |
|---|---|
comunidades | Comunidades autónomas: ccaa (código del INE) y nombre. |
provincias | Provincias: provincia (código del INE), nombre en castellano y ccaa, su comunidad autónoma. |
organismos | Organismos: id, nombre y grupo. |
areasgrupostipos_contratotipos_procesoaccesossistemasestados_proceso | Áreas profesionales, grupos de organismos, tipos de contrato, tipos de proceso, tipos de acceso, sistemas de selección y estados de los procesos, cada uno con id y nombre. |
Uso responsable
Este portal lo mantienen personas ajenas a la Administración, con recursos limitados, gracias a las contribuciones y donaciones de la comunidad. Se ruega hacer un uso responsable de los datos:
- Los ficheros se actualizan aproximadamente cada hora; no es necesario consultarlos con mayor frecuencia.
- Para detectar novedades, utilice novedades.json en lugar de descargar ofertas.json completo en cada consulta.
- Si su servicio tiene muchas personas usuarias, guarde una copia de los ficheros en su servidor en lugar de que cada navegador los descargue de este portal.
Licencia y atribución
Los datos pueden reutilizarse con la licencia CC BY 4.0, citando «Empleo en Empresas Públicas» y enlazando este portal. Los textos, documentos y enlaces de cada oferta y comunicado pertenecen a su organismo.
Si ofrece un servicio basado en estos datos, indique a sus personas usuarias que la inscripción se realiza en la web oficial de cada organismo: cada oferta incluye sus enlaces en url y url_inscripcion.