Aqui você pode encontrar informações sobre endpoints, parâmetros de resposta e possíveis erros de código após se conectar com sua chave de API REST. Se você ainda não se conectou, siga os passos em este guia para começar.

Como Obter a Chave de API?
Cadastre-se no site: https://pt.jooble.org/api/about
Após o cadastro, copie e salve a chave de API gerada para você.

Endpoints
Abaixo você pode encontrar os endpoints disponíveis que você pode usar para interagir com a API REST da Jooble para recuperar os dados desejados.

Parâmetros de Pedido:
POST /api/{api_Key} 

  • keywords: Palavras-chave para pesquisar empregos.
  • location: Localização para pesquisar empregos.
  • radius (opcional): Raio de pesquisa, convertido para quilômetros (tipo: string).
  • salary (opcional): Salário mínimo para a pesquisa de empregos (tipo: inteiro).
  • page (opcional): O número da página dos resultados da pesquisa.
  • ResultOnPage (opcional): Número de empregos exibidos em cada página.
  • SearchMode (opcional): O modo de pesquisa, padrão é 0.
  • companysearch (opcional):
    • true – Para pesquisar palavras-chave no nome da empresa do emprego.
    • false – Para pesquisar palavras-chave no título ou descrição do emprego.

Parâmetros de Resposta:

  • totalCount: Total de empregos encontrados para a solicitação de pesquisa.
  • jobs: Uma lista de empregos que correspondem aos critérios de pesquisa.
  • title: Título do emprego.
  • location: Localização do emprego.
  • snippet: Trecho da descrição do emprego exibido nos resultados da pesquisa.
  • salary: Intervalo salarial no formato {job.salary_val1} - {job.salary_val2} {currency}.
  • source: A fonte da vaga de emprego.
  • type: Tipo de emprego (tempo integral, meio período, etc.).
  • link: URL para a vaga de emprego.
  • company: Nome da_empresa.
  • updated: Data e hora da última atualização do emprego.
  • id: Identificador único do emprego.

Exemplo de Pedido JSON
POST https://jooble.org/api/{api_Key}

{
  "keywords": "Gerente de Vendas, Administrador",
  "location": "Kyiv",
  "radius": "80",
  "page": "1",
  "companysearch": "false"
}
Resposta de Sucesso: 200 OK

{  "totalCount": 1,  
    "jobs": [    
    {   "title": "Gerente de Vendas",      
        "location": "Kyiv",      
        "snippet": "Esta é uma ótima oportunidade para se juntar à nossa equipe...",      
        "salary": "17,600 UAH",      
        "source": "jooble",      
        "type": "Tempo Integral",      
        "link": "https://pt.jooble.org/jdp/12345",      
        "company": "ABC Corp",      
        "updated": "2023-09-15T12:55:35.3870000",      
        "id": 1234567890    }  ] 
}
Respostas de Erro:
403: Acesso negado – Chave de API inválida.
404: Não encontrado & ndash; O endpoint ou recurso solicitado não está disponível.

Exemplo de Uso da API Jooble em Código
Você pode implementar a API Jooble usando PHP, JavaScript, Ruby, C# (.NET 4 ou posterior), Python 3.5 ou Python 2.7. Exemplos de código detalhados para cada linguagem podem ser encontrados na página sobre a API Jooble, mostre isso ao seu programador.

Documentação da API REST Jooble