🎯 RemoteOK AI Job Matcher - Intelligent Job Matching with AI The smartest way to match remote jobs to your skills. Unlike basic job scrapers, this actor uses AI-powered analysis to intelligently match jobs to multiple candidate profiles with relevance scoring and detailed reasoning. ## 🚀 What Makes This Different? While other actors simply scrape job listings, RemoteOK AI Job Matcher goes further: ✅ AI-Powered Matching - Uses Groq LLM (llama3.1-70b-versatile) for intelligent profile analysis ✅ Multi-Profile Support - Match jobs for entire teams in one run ✅ Smart Scoring - Each match gets a 0-1 relevance score with detailed reasons ✅ Personalized Results - Tailored job recommendations per profile ✅ Comprehensive Data - Includes salary, company info, tags, and direct application links ## 💡 Perfect For - 🔍 Job Seekers - Find remote positions perfectly matched to your skills - 👥 Recruiters - Match candidates to opportunities at scale - 🏢 HR Teams - Automated talent sourcing and market analysis - 🤖 Developers - Build intelligent job recommendation systems - 📊 Analysts - Track remote job market trends and salary data ## 📊 What Data Can You Get? Each matched job includes: - Job Details: Position, company name, company logo - Location: Remote/hybrid/specific locations - Skills & Tags: Technologies, programming languages, frameworks - Salary: Min/max salary range (when available) - Description: Full job description - URLs: Job listing URL and direct application link - Match Score: AI-calculated relevance (0-1) - Match Reasons: Detailed explanation of why this job matches ## 🎯 Input Configuration ### Basic Example json { "profiles": [ { "name": "Senior Full Stack Developer", "extractedKeywords": ["React", "Node.js", "TypeScript", "AWS", "Docker"], "preferredRoles": ["Full Stack Developer", "Senior Software Engineer"], "locations": ["Remote", "United States"] } ], "maxJobs": 100 } ### Advanced Multi-Profile Example json { "profiles": [ { "name": "Full Stack Developer", "extractedKeywords": ["JavaScript", "TypeScript", "React", "Node.js", "PostgreSQL", "AWS"], "preferredRoles": ["Full Stack Developer", "Senior Full Stack Engineer", "Backend Developer"], "locations": ["Remote", "United States", "Europe"] }, { "name": "DevOps Engineer", "extractedKeywords": ["Kubernetes", "Docker", "AWS", "Terraform", "CI/CD", "Python"], "preferredRoles": ["DevOps Engineer", "Site Reliability Engineer", "Platform Engineer"], "locations": ["Remote", "Worldwide"] }, { "name": "Data Scientist", "extractedKeywords": ["Python", "Machine Learning", "TensorFlow", "PyTorch", "SQL", "NLP"], "preferredRoles": ["Data Scientist", "ML Engineer", "AI Researcher"], "locations": ["Remote", "United States", "Canada"] } ], "maxJobs": 150, "keywords": ["startup", "series-a"], "locations": ["Remote"] } ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | profiles | Array | ✅ Yes | Array of candidate profiles to match jobs against | | profiles[].name | String | ✅ Yes | Profile identifier/name | | profiles[].extractedKeywords | Array | ✅ Yes | Skills, technologies, frameworks (e.g., ["React", "Python", "AWS"]) | | profiles[].preferredRoles | Array | ✅ Yes | Desired job titles (e.g., ["Software Engineer", "Tech Lead"]) | | profiles[].locations | Array | ❌ No | Preferred work locations (e.g., ["Remote", "San Francisco"]) | | maxJobs | Number | ❌ No | Maximum jobs to fetch (default: 50, max: 200) | | keywords | Array | ❌ No | Additional filter keywords (e.g., ["web3", "crypto"]) | | locations | Array | ❌ No | Additional location filters (default: ["Remote"]) | ## 📤 Output Format ### Dataset Output json { "timestamp": "2025-12-06T10:30:00.000Z", "jobCount": 87, "matches": [ { "profile": "Full Stack Developer", "jobs": [ { "id": "1129105", "position": "Senior Full Stack Engineer", "company": "TechCorp", "company_logo": "https://remoteok.com/assets/img/company-logo.png", "location": "Remote, Worldwide", "tags": ["react", "nodejs", "typescript", "aws", "docker"], "description": "We're looking for a senior full stack engineer...", "salary_min": 120000, "salary_max": 180000, "date": "2025-12-05T12:00:00+00:00", "url": "https://remoteok.com/remote-jobs/1129105", "apply_url": "https://company.com/apply", "score": 0.92, "matchReasons": [ "Strong keyword match: React, Node.js, TypeScript, AWS", "Exact role match: Senior Full Stack Engineer", "Location match: Remote", "Salary range matches expectations" ] } ] } ], "summary": "Found 87 jobs matching 3 profile(s). Top matches: Full Stack Developer (32 jobs), DevOps Engineer (28 jobs), Data Scientist (27 jobs)", "inputMeta": { "profileCount": 3, "maxJobs": 150 } } ## 🔧 How It Works 1. Profile Analysis 🧠 - AI analyzes each profile to understand skills and preferences 2. Job Fetching 📥 - Retrieves latest remote jobs from RemoteOK (5000+ positions) 3. Smart Filtering 🎯 - Applies keyword and location filters 4. AI Matching 🤖 - Scores each job against each profile using: - Keyword/skill overlap analysis - Role title semantic matching - Location preference matching - Salary range compatibility 5. Ranking 📊 - Sorts matches by relevance score (highest first) 6. Detailed Output 📤 - Returns jobs with scores and match explanations ## 🏷️ Popular Skills & Tags Programming Languages: Python, JavaScript, TypeScript, Go, Rust, Java, Ruby, PHP Frontend: React, Vue, Angular, Next.js, Svelte Backend: Node.js, Django, FastAPI, Express, Spring Boot DevOps: Kubernetes, Docker, AWS, Azure, GCP, Terraform, CI/CD Data: Machine Learning, AI, Data Science, Analytics, SQL, NoSQL Design: UI/UX, Figma, Product Design Marketing: SEO, Growth, Content Marketing, Digital Marketing ## 💰 Pricing Pay-per-result pricing: Only pay for the jobs you get matched with. Estimated costs: - 100 jobs matched: ~$0.10 - 500 jobs matched: ~$0.50 - 1000 jobs matched: ~$1.00 ## 🆚 Comparison with Basic Scrapers | Feature | RemoteOK AI Job Matcher | Basic Job Scrapers | |---------|------------------------|-------------------| | AI-Powered Matching | ✅ Yes | ❌ No | | Relevance Scoring | ✅ 0-1 Score + Reasons | ❌ No scoring | | Multi-Profile Support | ✅ Unlimited profiles | ❌ Single search | | Match Explanations | ✅ Detailed reasons | ❌ No explanations | | Personalization | ✅ Per profile | ❌ Generic results | | Salary Data | ✅ Included | ✅ Included | | Company Info | ✅ Included | ✅ Included | ## 🔐 Setup Requirements GROQ_API_KEY: Set as an Apify actor secret. Get your free API key at console.groq.com ## 🛠️ Tech Stack - Apify SDK v3 - Actor framework - Groq API - AI matching (llama3.1-70b-versatile) - RemoteOK API - Job data source - TypeScript - Type-safe development - Node.js 20 - Runtime environment ## 📈 Use Cases & Integrations ### For Job Seekers - Automated daily job matching - Multi-skill profile tracking - Career transition planning ### For Recruiters - Candidate-job matching at scale - Talent pool analysis - Market intelligence gathering ### For Developers - Build job recommendation platforms - Integrate with LangChain/LangFlow - Create custom recruitment tools - Power job boards with AI matching ### For HR Teams - Automated talent sourcing - Salary benchmarking - Skills gap analysis - Remote work trends tracking ## 🚀 Quick Start 1. Add to Apify: Click "Try for free" 2. Configure Input: Add your profiles (see examples above) 3. Set API Key: Add GROQ_API_KEY as actor secret 4. Run: Click "Start" and get matched jobs in seconds 5. Export: Download results as JSON, CSV, or Excel ## 📞 Support & Feedback Found a bug or have a feature request? Open an issue on GitHub or contact us through Apify. --- Built with ❤️ for the remote work community