linkedin-jobs-api-py 0.1.3

Unofficial LinkedIn Jobs scraper API for Python

linkedin-jobs-api-py

Unofficial LinkedIn Jobs API for Python - This project is inspired by an npm package linkedin-jobs-api from Vishwa Gaurav. Scrape LinkedIn job postings with all filters (keywork,location,remote, salary, experience, etc.).

🚀 Installation

pip install linkedin-jobs-api-py  

📖 Simple usage

from linkedin_jobs_api import query

# Basic search
jobs = query(keyword="python developer", location="Paris", limit="10")

for job in jobs:
    print(f"💼 {job['position']} @ {job['company']}")
    print(f"📍 {job['location']} | 💰 {job['salary']}")
    print(f"🔗 {job['jobUrl']}\n")

🔍 All available filters

Parameter	Possible values	Example
keyword	Free text	"data scientist"
location	City/Country	"Paris", "Dakar"
date_since_posted	"1hr","24hr","past week","past month"	"past week"
job_type	"full time", "part time", "contract", "temporary", "internship", "volunteer"	"full time"
remote_filter	"remote", "on site", "hybrid"	"remote"
salary	"40000", "60000", "100000", "120000"	"100000"
experience_level	"internship","entry level","associate", "senior", "director","executive"	"senior"
limit	"1","3"...."10"	"5"
page	"0", "1", "2"..."999" (10 jobs/page)	"1"
has_verification	True/False	True
under_10_applicants	True/False	True

💡 Complete examples

1. Simple search

jobs = query(keyword="frontend", location="Lyon", limit="5")

2. Remote + Recent full-time

jobs = query(
keyword="backend developer",
remote_filter="remote",
job_type="full time",
date_since_posted="past week",
limit="10"
)

3. Senior + good salary

jobs = query(
keyword="software engineer",
experience_level="senior",
salary="100000",
location="France",
limit="8"
)

4. “Easy” jobs (verified, <10 applicants)

jobs = query(
keyword="product manager",
has_verification=True,
under_10_applicants=True,
sort_by="recent"
)

5. Pagination (page 2)

jobs = query(keyword="devops", page="1", limit="10") # Jobs 11-20

📋 Structure of results

{
"position": "Senior Python Developer",
"company": "Google",
"companyLogo": "https://media...png",
"location": "Paris, Île-de-France",
"date": "2025-12-08",
"agoTime": "2 days ago",
"salary": "€80k-€120k",
"jobUrl": "https://www.linkedin.com/jobs/view/..."
}

🛠️ Development

Clone et install dev

git clone <repo>
cd linkedin-jobs-api-py
pip install -e .[dev]

⚠️ Warnings

• Unofficial use : Comply with LinkedIn's Terms of Use and rate limits.
• Browser simulation: Complete headers simulating an AJAX request from a real browser
• Rate limiting awareness: Moderate usage recommended, proxies required for high volumes
• Changes : LinkedIn may modify its APIs (regular updates).

📄 Licence

MIT License - see LICENSE

---

⭐ Star so useful!! | 🐛 Issues : GitHub