Leer una oferta de empleo
Una oferta de empleo esconde su información más útil entre párrafos de relleno sobre cultura organizacional y beneficios. 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.
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.
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.
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. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿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.
¿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.
¿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.
¿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.
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, y pronto desde nuestra app, el email y Telegram.
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 '{"input":"…"}'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({
"input": "…"
})
});
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={
"input": "…"
},
)
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" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
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
{
"input": "…"
}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. |