Resume Matching Python

Match resumes to job descriptions using Python and MagicalAPI.

This repository is a simple starter kit for developers who want to build AI-powered candidate matching, resume scoring, ATS automation, and recruiting workflows.

What you can build

• Resume-to-job matching systems
• Candidate scoring pipelines
• ATS ranking workflows
• Recruiting automation tools
• AI-powered hiring dashboards
• Applicant screening systems

Installation

git clone https://github.com/magicalapi/resume-matching-python.git
cd resume-matching-python

python -m venv .venv
source .venv/bin/activate

python -m pip install -r requirements.txt

Setup

Create a .env file:

cp .env.example .env

Add your API key:

MAGICAL_API_KEY=your_api_key_here

Get your API key

1. Go to https://panel.magicalapi.com/api-info
2. Sign up
3. Copy your API key
4. Add it to your .env file

Match a resume to a job description

python examples/match_resume_to_job.py

Example:

result = await client.resume_score.get_resume_score(
    url="https://example.com/resume.pdf",
    job_description="""
    We are looking for a Python backend developer with API,
    database, and cloud experience.
    """
)

Batch resume matching

python examples/batch_resume_matching.py

Score a candidate

python examples/score_candidate.py

Example output

{
  "score": 87,
  "reason": "Strong match for the backend engineering role."
}

Important

The API requires:

• A public resume PDF URL
• A job description string

Example:

result = await client.resume_score.get_resume_score(
    url="https://example.com/resume.pdf",
    job_description="Senior Python backend developer..."
)

Use the full MagicalAPI Python SDK

This repository focuses only on resume matching and candidate scoring.

For all MagicalAPI services, use the official SDK:

https://github.com/magicalapi/magicalapi-python

Supported MagicalAPI services

• Resume Parser
• Resume Checker
• Resume Matcher
• LinkedIn Profile Data
• LinkedIn Company Data

License

MIT