Extraer oferta de empleo
Una oferta de empleo es en el fondo un formulario disfrazado de artículo: puesto, ubicación, rango salarial, requisitos y descripción mezclados en HTML libre que cambia en cada sitio de empleo. Esta API de extracción de ofertas de empleo lee una vacante como lo haría un reclutador y la devuelve como campos estructurados, listos para una base de datos en vez de un párrafo de texto corrido.
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.
El problema particular de las páginas de empleo
Los sitios de empleo están entre las páginas menos estandarizadas de internet: una empresa publica el salario como un rango claro, otra lo esconde en una sola frase al final y una tercera simplemente lo omite. Los requisitos a veces aparecen en una lista con viñetas y a veces como un párrafo denso y único. El endpoint job-extract está afinado para esa variabilidad e identifica el título del puesto, la ubicación, el tipo de contrato, la información salarial cuando está presente y los requisitos centrales, sin importar qué tan libre sea la estructura de la página.
Cómo funciona la extracción de principio a fin
Se envía la URL de una oferta de empleo a POST /web/job-extract, se recibe un task_id de inmediato y la tarea se procesa de forma asíncrona en segundo plano. El resultado llega como campos estructurados —puesto, empresa, ubicación, tipo de contrato, rango salarial si se divulga, y un bloque limpio de requisitos y descripción—, entregado por webhook firmado o mediante un enlace firmado válido por 24 horas.
Dónde se usan los datos estructurados de vacantes
Los agregadores de empleo necesitan campos consistentes para alimentar filtros de búsqueda como rango salarial o remoto versus presencial. Las agencias de reclutamiento vigilan cuándo empresas específicas publican puestos que coinciden con el perfil de un cliente. Los analistas de compensación construyen referencias salariales recopilando rangos publicados en toda una industria. Cada uno de estos casos depende de convertir páginas de empleo inconsistentes en un esquema común, algo que la copia manual simplemente no soporta a ningún volumen real.
Por qué la transparencia salarial cambia lo que se puede extraer
Las leyes de transparencia salarial adoptadas en un número creciente de jurisdicciones en los últimos años han empujado a más empleadores a publicar el rango salarial directamente en la oferta en lugar de reservarlo hasta la entrevista. Ese cambio implica que la extracción estructurada cada vez captura datos reales de compensación y no solo descripciones del puesto, aunque el campo se deja vacío cuando una oferta genuinamente no lo divulga, en lugar de inventarlo.
Mantener actualizado un feed de vacantes
Como las tareas fallidas nunca se cobran —tres reintentos y luego un error claro—, este endpoint se adapta bien a un rastreo recurrente de páginas de empleo para detectar nuevas publicaciones o notar cuando un anuncio se retira, alimentando una bolsa de trabajo o un panel interno de inteligencia de talento sin que nadie revise cada página.
Qué puede hacer con ella
Agregación de bolsas de trabajo
Un agregador extrae ofertas de decenas de páginas de empleo de distintas empresas y las normaliza en un solo formato buscable.
Generación de leads para agencias de reclutamiento
Una agencia vigila empresas objetivo en busca de nuevas vacantes que coincidan con el mandato de contratación de un cliente.
Referencias de compensación
Un equipo de People Ops recopila los rangos salariales divulgados en toda una industria para calibrar sus propias bandas de oferta.
Inteligencia competitiva de contratación
Una startup sigue qué puestos está contratando activamente un competidor como señal de dónde está invirtiendo.
Preguntas frecuentes
¿Esta api extraer ofertas de empleo también extrae la información salarial?
Sí, cuando una oferta divulga un salario o rango salarial, se captura como campo estructurado; si la oferta no lo divulga, el campo simplemente queda vacío.
¿Existe un plan gratuito para la API de extracción de 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.
¿Cuánto cuesta la API de extracción de ofertas de empleo?
Cuesta 0.046 dólares por solicitud más 0.015 dólares por URL, y solo se cobra cuando la extracción tiene éxito.
¿Qué campos devuelve además del título del puesto?
Normalmente empresa, ubicación, tipo de contrato, rango salarial si se divulga, y una sección limpia de requisitos y descripción.
¿Puedo procesar muchas ofertas de empleo en lote?
Sí, se puede enviar un lote de URL de vacantes y cada una se procesa y factura por separado según la tarifa por URL.
¿Qué pasa si una página de empleo no carga?
La tarea reintenta automáticamente hasta tres veces antes de devolver un error claro, y una tarea fallida nunca se cobra.
¿Cómo se entrega la información extraída de la vacante?
Mediante un webhook firmado, recomendado para flujos automatizados, o un enlace firmado que permanece válido durante 24 horas.
¿Funciona en distintos sistemas de seguimiento de candidatos y sitios de empleo?
Sí, está diseñado para manejar la variabilidad entre distintos diseños de páginas de empleo en lugar de depender de una sola plantilla.
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/web/job-extract \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://ejemplo.com"}'const res = await fetch("https://api.kit.forhosting.com/web/job-extract", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"url": "https://ejemplo.com"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/job-extract",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"url": "https://ejemplo.com"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/job-extract", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"url":"https://ejemplo.com"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"url":"https://ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/job-extract", 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
{
"url": "https://ejemplo.com"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.job_extract",
"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
timeout_sec | 30 |
max_crawl_pages | 25 |
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. |