🎯 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

{
  "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

{
  "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

{
  "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