A FastAPI service that scrapes remote job listings from LinkedIn.
- Python 3.7+
- Chrome/Chromium browser
- ChromeDriver (matching your Chrome version)
- Clone the repository and navigate to the project directory:
git clone https://github.com/lanznx/linkedin-remote-job-scraper.git
cd linkedin-remote-job-scraper- Create and activate a virtual environment:
python -m venv .venv
source .venv/bin/activate # Linux/macOS
# or
.\.venv\Scripts\activate # Windows- Install dependencies using
uv:
uv pip install -r requirements.txt- Start the server:
uv venv run uvicorn app.main:app --reloadThe service will be available at:
- API: http://localhost:8000
- API Documentation: http://localhost:8000/docs
Test the API using curl:
curl -X POST "http://localhost:8000/scraper/jobs/" \
-H "Content-Type: application/json" \
-d '{"locations": ["United States"], "limit": 10}'For hot-reload during development:
uv venv run uvicorn app.main:app --reload --port 8000