Reddit Job Search

A comprehensive Reddit job search client for finding tech and programming jobs across multiple subreddits. Includes both CLI and API client components.

Features

• 🔍 Search across multiple tech job subreddits
• 💰 Automatic salary range detection
• 🏢 Location detection (remote, on-site, specific cities)
• 💻 Tech stack detection (React, Node.js, Python, etc.)
• 👨‍💼 Experience level detection (entry, junior, mid, senior, lead)
• 📊 Employment type detection (full-time, contract, etc.)
• 💾 JSON storage support
• 🎨 Pretty console output with colors

Installation

# As a global CLI tool
npm install -g @arya09021998/reddit-job-search

# As a project dependency
npm install @arya09021998/reddit-job-search

CLI Usage

# Search for remote React jobs
reddit-jobs --tech react --location remote

# Search for full-time Node.js jobs with minimum salary
reddit-jobs --tech nodejs --type full-time --min-salary 100000

# Save results to JSON file
reddit-jobs --tech "python,django" --save jobs.json

# Get JSON output
reddit-jobs --tech typescript --format json

API Usage

import { RedditClient } from '@arya09021998/reddit-job-search';

const client = new RedditClient();

// Search for tech jobs
const jobs = await client.searchTechJobs({
  techStack: ['react', 'typescript'],
  location: 'remote',
  minSalary: 100000,
  employmentType: ['full-time'],
  days: 30,
  limit: 25
});

console.log(jobs);

API Documentation

CLI Options

• --tech: Technologies to filter for (comma-separated)
• --location: Location filter (e.g., remote, NYC)
• --min-salary: Minimum salary filter
• --max-salary: Maximum salary filter
• --type: Employment types (comma-separated)
• --days: Number of days to look back
• --limit: Number of results to return
• --save: Save results to JSON file
• --format: Output format (json or pretty)

API Methods

RedditClient

The main class for searching and filtering Reddit job posts.

searchTechJobs(options)

Search for tech jobs with filtering options:

• techStack: string[] - Technologies to filter for
• location: string - Location filter
• minSalary: number - Minimum salary filter
• maxSalary: number - Maximum salary filter
• employmentType: string[] - Employment type filter (e.g., ["full-time", "contract"])
• days: number - Number of days to look back
• limit: number - Number of results to return (default: 25)

Returns a Promise with job results including title, description, salary, location, tech stack, etc.

JobStorage

Utility class for saving job results.

saveToJson(jobs, filePath)

Save job results to a JSON file:

• jobs: JobPost[] - Array of job posts to save
• filePath: string - Path to save the JSON file

License

MIT License