Leer una oferta de empleo
Una oferta de empleo esconde lo útil entre párrafos sobre cultura y beneficios: esta herramienta extrae las competencias exigidas, los años de experiencia, el nivel, la ubicación y la banda salarial cuando aparece, listas para cruzarlas con candidatos.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Una oferta de empleo esconde su información más útil entre párrafos de relleno sobre cultura organizacional y beneficios.
Lo que de verdad contiene una oferta
Los portales de empleo, los sistemas de selección y las intranets publican las ofertas como texto libre. Eso sirve para que una persona eche un vistazo, pero no para emparejar candidatos con vacantes a gran escala. Esta herramienta lee la descripción como lo haría un reclutador y se queda con lo que decide un emparejamiento: competencias exigidas, años de experiencia, nivel del puesto, ubicación y banda salarial si la oferta la indica. Puede partir de un texto copiado de una página de empleo o exportado de su sistema de selección, y el resultado le llega con un aviso o mediante un enlace privado válido durante 24 horas.
Para qué sirve y el error más común
Cruce los requisitos extraídos con currículos ya analizados para puntuar el encaje sin depender de búsquedas por palabra clave, reúna bandas salariales y niveles de miles de ofertas para seguir las tendencias de contratación de un sector, o etiquete cada vacante con sus competencias en cuanto el responsable la publica. El error más común es copiar las frases tal cual. Dos empresas describen la misma necesidad con palabras distintas, como dominio de hojas de cálculo, Excel avanzado o sólidas capacidades cuantitativas, así que extraer bien significa reconocer esa coincidencia.
Qué puede hacer con ella
Agregación de bolsas de empleo
Normalice miles de ofertas extraídas de distintos sitios de empleo en un esquema uniforme para búsqueda y filtrado.
Emparejamiento candidato-vacante
Combine los requisitos extraídos de la oferta con datos de currículums procesados para calificar el ajuste de forma automática.
Análisis salarial y de mercado
Extraiga rangos salariales y niveles de experiencia de miles de ofertas para seguir tendencias de contratación en un sector.
Etiquetado automático en el ATS interno
Etiquete automáticamente cada vacante abierta con campos estructurados de habilidad y nivel apenas un gerente la publica.
Preguntas frecuentes
¿Qué datos extrae la api leer ofertas de empleo?
Competencias requeridas, nivel de experiencia, años requeridos, ubicación y detalles de compensación cuando la oferta los incluye.
¿Funciona con ofertas de cualquier bolsa de empleo?
Sí, lee descripciones en texto libre sin importar el diseño del sitio de origen ni cómo se copió o exportó la oferta.
¿Hay prueba gratuita para la api leer ofertas de empleo?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Se cobra una extracción fallida?
No. Las tareas fallidas se reintentan automáticamente hasta tres veces y nunca se cobran; solo se factura un análisis exitoso.
¿Reconoce sinónimos al describir las competencias?
Está diseñada para leer los requisitos como lo haría un reclutador, capturando la intención y no solo coincidencias exactas de palabras.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/ocr/job-post \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"El informe trimestral cerró con 1,2 M€ de ingresos."}'const res = await fetch("https://api.kit.forhosting.com/ocr/job-post", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "El informe trimestral cerró con 1,2 M€ de ingresos."
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ocr/job-post",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "El informe trimestral cerró con 1,2 M€ de ingresos."
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ocr/job-post", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"El informe trimestral cerró con 1,2 M€ de ingresos."}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"El informe trimestral cerró con 1,2 M€ de ingresos."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ocr/job-post", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"text": "El informe trimestral cerró con 1,2 M€ de ingresos."
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ocr.job_post",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 10 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |
Notas técnicas
Este endpoint lee la descripción del puesto como lo haría un reclutador de sourcing y extrae lo que realmente sirve para hacer coincidencias: competencias requeridas, años de experiencia, nivel, ubicación y rango salarial.
La brecha entre una oferta y un requisito consultable
Las bolsas de empleo, los sistemas de reclutamiento y las intranets publican ofertas en texto libre, algo cómodo para una persona que hojea una página pero inútil para un software que intenta emparejar candidatos con vacantes a escala. Este endpoint cierra esa brecha: toma la descripción cruda, ya sea copiada de una página de carreras o exportada de un ATS, y la convierte en un requisito que su lógica de emparejamiento puede consultar.
Cómo se mueve una solicitud dentro del sistema
Envía la descripción del puesto a POST /ocr/job-post y recibe un task_id de inmediato, porque la extracción corre de forma asíncrona en segundo plano. El resultado estructurado —competencias, requisitos, nivel de experiencia, datos salariales cuando están presentes— llega mediante un webhook firmado, o puede obtenerlo desde un enlace firmado que permanece válido 24 horas después de completarse la tarea.
Las ofertas cambiaron de medio, pero la ambigüedad quedó igual
Las ofertas de empleo pasaron de los clasificados de periódico a las bolsas digitales hace décadas, pero el problema de fondo nunca desapareció: dos empresas que describen el mismo puesto usan palabras completamente distintas para el mismo requisito —'manejo de hojas de cálculo' frente a 'Excel avanzado' frente a 'fuertes habilidades cuantitativas'. Extraer estructura significa reconocer esa equivalencia, no solo copiar frases al pie de la letra, y ahí es donde este endpoint aporta más que una simple búsqueda por palabra clave.
Dónde encaja dentro de una plataforma de contratación
Los agregadores lo usan para normalizar ofertas extraídas de decenas de fuentes en una sola taxonomía; las herramientas internas de recursos humanos lo usan para etiquetar automáticamente vacantes abiertas con códigos de habilidad; los motores de emparejamiento usan la salida como contraparte de un currículum ya procesado, de modo que ambos lados de la comparación hablan el mismo lenguaje estructurado.
Precio claro y publicado
Cada extracción cuesta $0.003 por solicitud más $0.0135 por documento, cobrado solo cuando el análisis se completa con éxito; los fallos se reintentan automáticamente hasta tres veces y nunca se cobran si aun así no se resuelven. Como el acceso requiere saldo prepago en lugar de una capa gratuita, el endpoint se mantiene rápido y predecible, sin tráfico desechable que lo ralentice.
Preguntas técnicas
¿Cómo recibo los resultados extraídos?
Mediante un webhook firmado cuando termina el procesamiento, o desde un enlace firmado válido por 24 horas.
¿Puedo procesar ofertas de empleo en lote?
Sí, envíe cada oferta como una solicitud independiente; cada llamada es asíncrona con su propio task_id para correr en paralelo.
¿Cuál es el precio de la api leer ofertas de empleo?
$0.003 por solicitud más $0.0135 por documento, publicado abiertamente sin créditos ocultos.