Modificado en: 16 Aug, 2026

Esta guía ofrece la documentación para integrarte con la Jooble REST API. A continuación, encontrarás información sobre la generación de claves de API, endpoints, parámetros de solicitud, formatos JSON y códigos de respuesta comunes. Si aún no has iniciado la integración, consulta nuestra guía paso a paso sobre Cómo conectarse a la Jooble REST API después de recibir la clave.

Restricciones regionales importantes:
Cada dominio de Jooble (país) requiere su propia clave de REST API única. Por ejemplo, una clave generada en jooble.org ofrece acceso exclusivo a las ofertas de empleo de EE. UU. Para buscar ofertas de empleo en otros países, regístrate y obtén una clave de API en el dominio regional correspondiente (por ejemplo, uk.jooble.org/api/about para el Reino Unido o de.jooble.org/api/about para Alemania).
Límites de uso de la API:
El plan gratuito de la REST API incluye un límite total de por vida de 500 solicitudes por clave (este es un cupo absoluto de por vida, no un límite mensual).

Cómo obtener una clave de Jooble REST API

  1. Registra una cuenta en el portal de la API de Jooble para tu país de destino (por ejemplo, es.jooble.org/api/about).
  2. Una vez registrado, copia y guarda de forma segura la clave de API generada.

Parámetros de solicitud (Cuerpo JSON)

El payload de la solicitud debe enviarse en formato application/json con los siguientes parámetros:

  • keywords(string, obligatorio): Palabras clave o puestos de trabajo a buscar.
  • location(string, obligatorio): Nombre de la ubicación (ciudad, región o país).
  • radius(string, opcional): Radio de búsqueda en kilómetros. Valores permitidos: 0, 4, 8, 16, 26, 40, 80.
  • salary(integer, opcional): Umbral de salario mínimo.
  • page(integer, opcional): Número de página de los resultados de búsqueda (el valor predeterminado es 1).
  • ResultOnPage(integer, opcional): Número de ofertas de empleo devueltas por página.
  • SearchMode(integer, opcional): Modo del algoritmo de búsqueda (el valor predeterminado es 0).
  • companysearch(boolean, opcional):
    • true – Buscar palabras clave específicamente dentro de los nombres de empresas.
    • false – Buscar palabras clave en puestos de trabajo y descripciones del empleo.

Parámetros de respuesta

Tras una solicitud exitosa, el servidor devuelve un objeto JSON que contiene:

  • totalCount(integer): Número total de ofertas de empleo coincidentes encontradas.
  • jobs(array): Lista de objetos de ofertas de empleo que contienen:
    • id(integer): Identificador único de la oferta de empleo.
    • title(string): Puesto de trabajo.
    • location(string): Ubicación de la oferta de empleo.
    • snippet(string): Fragmento breve de descripción que se muestra en los resultados de búsqueda.
    • salary(string): Rango salarial con formato {min} - {max} {currency}.
    • source(string): Origen de la oferta de empleo.
    • type(string): Tipo de empleo (por ejemplo, Jornada completa, Media jornada).
    • link(string): Enlace directo a la oferta de empleo en Jooble.
    • company(string): Nombre de la empresa.
    • updated(string): Marca de tiempo ISO de la última actualización de la oferta de empleo.

Ejemplos de solicitud y respuesta JSON

Ejemplo de payload de solicitud:

POST https://es.jooble.org/api/{api_Key} Content-Type: application/json { "keywords": "Sales Manager, Administrator", "location": "Kyiv", "radius": "80", "page": "1", "companysearch": "false" }

Ejemplo de respuesta exitosa (200 OK):

{ "totalCount": 1, "jobs": [ { "id": 1234567890, "title": "Sales Manager", "location": "Kyiv", "snippet": "This is a great opportunity to join our team...", "salary": "17,600 UAH", "source": "jooble", "type": "Full-time", "link": "https://ua.jooble.org/jdp/12345", "company": "ABC Corp", "updated": "2023-09-15T12:55:35.3870000" } ] }

Códigos de respuesta HTTP y de error

  • 200 OK: La solicitud fue exitosa y devolvió datos.
  • 403 Access Denied: Clave de API no válida o ausente.
  • 404 Not Found: El endpoint o recurso solicitado no existe.

Ejemplos de implementación de código

Puedes integrar la Jooble REST API usando lenguajes de programación como PHP, JavaScript, Python (2.7 / 3.5+), C# (.NET 4+), Ruby y otros. Los fragmentos de código listos para usar y las guías de implementación están disponibles en nuestra página de documentación de la API de Jooble.