API-Request-Net-Empregos

This Python project automates job postings on Net-Empregos, a prominent job portal in Portugal.
It streamlines the process of submitting job listings, ensuring efficiency and consistency.

Features

• Automated Job Posting: Programmatically submit job listings to Net-Empregos.
• Data Cleaning: Sanitize and prepare job data for submission.
• Configurable Mappings: Use mapping.json to map internal job fields to Net-Empregos' expected format.
• Error Handling: Gracefully handle and log errors during the posting process.

Prerequisites

• Python 3.8 or higher
• A Net-Empregos account with API access
• API access key set as an environment variable

Installation

1. Clone the repository:

   git clone https://github.com/srdobolo/API-Request-Net-Empregos.git
   cd API-Request-Net-Empregos
   

2. Create a virtual environment (optional but recommended):

   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   

3. Install dependencies:

• For general use:

  pip install -r requirements.txt
  

• For Linux systems:

  pip install -r requirements_linux.txt
  

Configuration

1. Set the API access key:

You can either:

• Set it in the shell:

  export API_ACCESS_KEY='your_api_key_here'
  

• Or create a .env file:

  echo "API_ACCESS_KEY=your_api_key_here" > .env
  

2. Configure mapping.json:

This file maps your internal job fields to the format expected by Net-Empregos. Ensure it's correctly set up before running the script.

Usage

• To run the main script:

  python main.py
  

The script will:

• Read job data
• Clean and format it
• Map fields via mapping.json
• Submit job listings to Net-Empregos

File Structure

• main.py: Entry point of the application.
• data_cleaning.py: Functions to sanitize and prepare job data.
• Remove_Request.py: Handles the removal of job postings (if implemented).
• mapping.json: JSON file mapping internal job fields to Net-Empregos format.
• requirements.txt: Python dependencies.
• requirements_linux.txt: Dependencies tailored for Linux.
• Net-Empregos Interface.doc.pdf: Documentation for the Net-Empregos interface.

Troubleshooting

• Error: API_ACCESS_KEY is not set in the environment or .env file. → Make sure the key is set either in the shell or a .env file in the project root.

• Process completed with exit code 1 → This indicates an error during execution. Check console output and ensure configurations are correct.

License

This project is licensed under the MIT License.