/ApiVagasEmpregoDevPython

Primary LanguagePython

Web Scraping de Vagas de Emprego

Status do Projeto

Sobre • Funcionalidades • Layout • Endpoints da API • Como Executar • Tecnologias Utilizadas • Contribuidores • Autor • Licença

💻 Sobre o Projeto

📄 O projeto consiste em um web scraping para extrair vagas de emprego de um determinado site, fornecendo informações relevantes sobre as oportunidades disponíveis. Este projeto é desenvolvido para fins educacionais, visando a prática de web scraping e desenvolvimento de APIs simples.

⚙️ Funcionalidades

  • Extração de vagas de emprego
  • Filtros de pesquisa
  • Visualização das informações das vagas

📤 Propiedades retornada:

  • Nome da vaga
  • Nome da empresa
  • ID da vaga
  • Localização
  • Tipo de contrato
  • Salário
  • Nível da vaga
  • Data de publicação
  • Link da vaga
  • Tipo de empresa

🔢 Parâmetros de consulta:

  • page: Número da página a ser consultada (opcional, padrão é 1).
  • expertise: Especialidade da vaga (opcional).
  • city: Cidade da vaga (opcional).

🔗 Endpoints da API

  • Obter todas as vagas de emprego disponíveis
Método HTTP: GET
Endpoint: /vagas
  • Obter vagas de emprego disponíveis em uma cidade específica
Método HTTP: GET
Endpoint: /vagas?city={nome_da_cidade}
Exemplo de uso: /vagas?city=sao-paulo
  • Obter vagas de emprego disponíveis em uma área de expertise específica
Método HTTP: GET
Endpoint: /vagas?expertise={area_de_expertise}
Exemplo de uso: /vagas?expertise=python
  • Obter vagas de emprego disponíveis em uma página específica
Método HTTP: GET
Endpoint: /vagas?page={numero_da_pagina}
Exemplo de uso: /vagas?page=2
  • Obter vagas de emprego disponíveis com filtro de cidade e área de expertise
Método HTTP: GET
Endpoint: /vagas?city={nome_da_cidade}&expertise={area_de_expertise}
Exemplo de uso: /vagas?city=sao-paulo&expertise=python

🛣️ Como Executar o Projeto

Pré-requisitos Antes de iniciar, verifique se você atende aos seguintes requisitos: Python 3.x instalado em sua máquina.

🧭 Rodando o Projeto

#Clone este repositório:
$ git clone https://github.com/moabesouza/ApiVagasEmpregoDevPython

🛠 Tecnologias Utilizadas As seguintes ferramentas foram usadas na construção do projeto:

  • Python
  • Beautiful Soup (biblioteca Python para web scraping)
  • Flask (para a criação da API)

💪 Como contribuir para o projeto

  1. Faça um fork do projeto.
  2. Crie uma nova branch com as suas alterações: git checkout -b my-feature
  3. Salve as alterações e crie uma mensagem de commit contando o que você fez: git commit -m "feature: My new feature"
  4. Envie as suas alterações: git push origin my-feature

Caso tenha alguma dúvida confira este guia de como contribuir no GitHub