Skip to main content

​
Overview

The Matching API provides intelligent job matching capabilities using AI algorithms to connect job seekers with relevant opportunities and help companies find the best candidates for their job postings.

​
How It Works

​
For Job Seekers

When your CV is processed, our AI system analyzes your skills, experience, and preferences to match you with relevant job opportunities from:
  • Direct Jobs: Positions posted directly by companies on CareerK
  • Scraped Jobs: Opportunities gathered from external job boards

​
For Companies

When you post a job, our AI system matches your requirements against all job seeker profiles to find the most qualified candidates based on:
  • Skills and experience
  • Location preferences
  • Availability status
  • Job requirements compatibility

​
Match Score

Each match includes a match score (0-100) representing the compatibility level:

​
Available Endpoints

​
Job Seeker Endpoints

Get My Matches

Retrieve job matches with filtering and pagination

​
Company Endpoints

Get Job Matches

Retrieve candidate matches for a specific job posting

​
Notifications

​
For Job Seekers

When new scraped job matches are found that meet your criteria, you’ll receive an email notification with the top matching opportunities.

​
For Companies

When the matching process completes for your direct job postings, you’ll receive an email summary with the number of matched candidates.

​
Filtering Options

​
Job Seeker Filters

  • Type: Filter by job source (all, direct, scraped)
  • Search: Full-text keyword search across title, description, company, and skills
  • Job Type: Filter by employment type (FULL_TIME, PART_TIME, CONTRACT, etc.)
  • Location: Filter by location (partial match)
  • Work Preference (direct only): REMOTE, ONSITE, HYBRID
  • Experience Level (direct only): ENTRY, JUNIOR, MID, SENIOR, LEAD, MANAGER
  • Salary Range (direct only): Filter by salaryMin and salaryMax
  • Scraped Source (scraped only): Filter by job board name (LinkedIn, Indeed)
  • Min Score: Set minimum match score threshold
  • Pagination: Control results with page and limit parameters

​
Company Filters

  • Min Score: Set minimum match score threshold
  • Availability Status: Filter by candidate availability (OPEN_TO_WORK, NOT_LOOKING, PASSIVELY_LOOKING)
  • Pagination: Control results with page and limit parameters

​
Best Practices

Complete Your Profile: Job seekers should complete their profile with detailed work experience, education, and skills to improve match accuracy.
Set Clear Requirements: Companies should provide detailed job descriptions and requirements to get better candidate matches.
Use Minimum Score Filtering: Filter matches with a minimum score of 50+ to focus on high-quality matches.