@atharvh01/linkedin-jobs-api

LinkedIn Jobs API

An unofficial API to fetch job listings from LinkedIn. This API allows you to search for jobs using keywords, location, and date filters.

Created by: Atharv Hatwar

Features

• 🔍 Search jobs by keywords
• 📍 Filter by location
• 📅 Filter by posting date
• 🧹 Clean and formatted job data
• 🌐 CORS enabled
• ⚠️ Error handling
• 🛡️ Rate limiting protection

Installation

npm install @atharvh01/linkedin-jobs-api

Quick Start

import express from 'express';
import { searchJobs } from '@atharvh01/linkedin-jobs-api';

const app = express();
const PORT = 3000;

app.get('/api/search', searchJobs);

app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

API Endpoints

Search Jobs

GET /api/search

Query Parameters

Parameter	Type	Required	Description
keywords	string	Yes	Search terms (e.g., "react developer")
location	string	Yes	Job location (e.g., "remote", "Pune")
dateSincePosted	string	No	Filter by post date (past_24h, past_week, past_month)

Example Request

GET /api/search?keywords=react&location=remote&dateSincePosted=past_24h

Example Response

{
  "success": true,
  "count": 2,
  "jobs": [
    {
      "title": "Senior React Developer",
      "company": "Example Corp",
      "location": "Remote",
      "link": "https://www.linkedin.com/jobs/view/123456789",
      "postedDate": "2023-12-20T10:00:00.000Z",
      "description": "We are looking for a Senior React Developer..."
    }
  ]
}

Error Handling

The API returns appropriate error messages and status codes:

{
  "success": false,
  "error": {
    "message": "Keywords parameter is required",
    "status": 400
  }
}

Rate Limiting

To prevent abuse, the API implements rate limiting:

• 100 requests per hour per IP
• Customizable limits through configuration

Testing

# Run the test suite
npm test

# Test specific endpoints
npm run test:api

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Atharv Hatwar

• GitHub: atharvhatwar

Legal Notice

This package is for educational purposes only. Please review LinkedIn's terms of service before using this API in production.