PHPackages                             sharpapi/laravel-resume-job-match-score - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. sharpapi/laravel-resume-job-match-score

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

sharpapi/laravel-resume-job-match-score
=======================================

AI Resume &amp; Job Description Matching for Laravel powered by SharpAPI.com

v1.0.3(1mo ago)442MITPHPPHP ^8.1

Since May 1Pushed 1mo agoCompare

[ Source](https://github.com/sharpapi/laravel-resume-job-match-score)[ Packagist](https://packagist.org/packages/sharpapi/laravel-resume-job-match-score)[ Docs](https://github.com/sharpapi/laravel-resume-job-match-score)[ RSS](/packages/sharpapi-laravel-resume-job-match-score/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (10)Versions (5)Used By (0)

[![SharpAPI GitHub cover](https://camo.githubusercontent.com/82bb36706c1e71276b3dca4ec9120353bb51c8f22bb62543bf056db5c28da36d/68747470733a2f2f73686172706170692e636f6d2f73686172706170692d6769746875622d6c61726176656c2d62672e6a7067 "SharpAPI Laravel Client")](https://camo.githubusercontent.com/82bb36706c1e71276b3dca4ec9120353bb51c8f22bb62543bf056db5c28da36d/68747470733a2f2f73686172706170692e636f6d2f73686172706170692d6769746875622d6c61726176656c2d62672e6a7067)

Laravel Resume/CV and Job Description Match Score
=================================================

[](#laravel-resumecv-and-job-description-match-score)

🎯 Instantly evaluate how well a candidate's resume aligns with your job descriptions — powered by SharpAPI AI.
--------------------------------------------------------------------------------------------------------------

[](#-instantly-evaluate-how-well-a-candidates-resume-aligns-with-your-job-descriptions--powered-by-sharpapi-ai)

Supported resume files - **11 file formats**: **DOC, DOCX, TXT, RTF, PDF, JPG, JPEG, JPE, PNG, TIFF, TIF**

And yes - it handles those **flattened PDFs** where the entire resume is just images instead of text.

[![Latest Version on Packagist](https://camo.githubusercontent.com/f4d2e7de57310884c76d641784cc850e8f9b605d8edc7238a85890d8796049f0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73686172706170692f6c61726176656c2d726573756d652d6a6f622d6d617463682d73636f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sharpapi/laravel-resume-job-match-score)[![Total Downloads](https://camo.githubusercontent.com/c07dbc34b1daea601a86cd6847c26aa2f59116ddd3672d37279fd2b3a68e6d57/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73686172706170692f6c61726176656c2d726573756d652d6a6f622d6d617463682d73636f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sharpapi/laravel-resume-job-match-score)

Check the full documentation on the [Resume/CV Job Match Scoring API](https://sharpapi.com/en/catalog/ai/hr-tech/resume-cv-job-match-score) page.

---

Requirements
------------

[](#requirements)

- PHP &gt;= 8.1
- Laravel &gt;= 10.48.29

---

Installation
------------

[](#installation)

```
composer require sharpapi/laravel-resume-job-match-score --prefer-dist
```

Then, in your `.env` file:

```
SHARP_API_KEY=your_api_key_here
```

Optionally, publish the config if you want to tweak the default settings:

```
php artisan vendor:publish --tag=sharpapi-resume-job-match-score
```

---

What it does
------------

[](#what-it-does)

This package sends a resume file and a job description to the SharpAPI AI endpoint and returns a structured JSON scoring output based on 20+ compatibility factors:

- Skills match
- Experience and industry relevance
- Education and certifications
- Soft skills, language, cultural fit
- Stability score and more

Perfect for recruiters, ATS platforms, and job-matching tools.

---

Usage
-----

[](#usage)

Inject the `ResumeMatchScoreService` into your controller or command and call `matchResumeToJob()`:

```
use SharpAPI\ResumeMatchScore\ResumeMatchScoreService;
use GuzzleHttp\Exception\GuzzleException;

$resumePath     = storage_path('resume.pdf');      // make sure this file exists
$jobDescription = 'We are hiring a PHP Developer with Laravel experience…';
$language       = 'English';

$service = new ResumeMatchScoreService();

try {
    $statusUrl = $service->matchResumeToJob(
        $resumePath,
        $jobDescription,
        $language          // optional – English is default
    );

    $result = $service->fetchResults($statusUrl)->toArray();
    print_r($result);
} catch (GuzzleException $e) {
    // Handle SharpAPI or network errors
    echo $e->getMessage();
}
```

---

Example Response
----------------

[](#example-response)

```
{
  "data": {
    "type": "api_job_result",
    "id": "5a113c4d-38e9-43e5-80f4-ec3fdea3420e",
    "attributes": {
      "status": "success",
      "type": "hr_resume_job_match_score",
      "result": {
        "match_scores": {
          "overall_match": 88,
          "skills_match": 92,
          "experience_match": 85,
          "education_match": 80,
          "certifications_match": 70,
          "job_title_relevance": 84,
          "industry_experience_match": 75,
          "project_experience_match": 78,
          "technical_stack_match": 90,
          "soft_skills_match": 88,
          "methodologies_match": 82,
          "language_proficiency_match": 95,
          "location_preference_match": 100,
          "remote_work_flexibility": 90,
          "certifications_training_relevance": 70,
          "years_experience_weighting": 80,
          "recent_role_relevance": 83,
          "management_experience_match": 60,
          "cultural_fit_potential": 85,
          "stability_score": 77
        },
        "explanations": {
          "skills_match": "Candidate lists React, Node.js, and JavaScript with strong proficiency.",
          "experience_match": "5+ years experience in a similar role within a tech startup.",
          "education_match": "Bachelor's degree in Computer Science aligns with job requirements.",
          "certifications_match": "Has partial certification coverage (e.g., Scrum Master).",
          "language_proficiency_match": "Fluent in English as required."
        }
      }
    }
  }
}
```

---

### Do you think our API is missing some obvious functionality?

[](#do-you-think-our-api-is-missing-some-obvious-functionality)

- [Please let us know via GitHub »](https://github.com/sharpapi/laravel-resume-job-match-score/issues)
- or [Join our Telegram Group »](https://t.me/sharpapi_community)

---

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

---

Credits
-------

[](#credits)

- [A2Z WEB LTD](https://github.com/a2zwebltd)
- [Dawid Makowski](https://github.com/makowskid)
- Boost your [Laravel AI](https://sharpapi.com/) capabilities!

---

License
-------

[](#license)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](LICENSE.md)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

---

Social Media
------------

[](#social-media)

🚀 For the latest news, tutorials, and case studies, don't forget to follow us on:

- [SharpAPI X (formerly Twitter)](https://x.com/SharpAPI)
- [SharpAPI YouTube](https://www.youtube.com/@SharpAPI)
- [SharpAPI Vimeo](https://vimeo.com/SharpAPI)
- [SharpAPI LinkedIn](https://www.linkedin.com/products/a2z-web-ltd-sharpapicom-automate-with-aipowered-api/)
- [SharpAPI Facebook](https://www.facebook.com/profile.php?id=61554115896974)

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance90

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~110 days

Total

4

Last Release

45d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2b500dd3d9b470b50b1ed911cd24a6fdcce51dd97dceb4f97879f727a14495a8?d=identicon)[dawid-makowski](/maintainers/dawid-makowski)

---

Top Contributors

[![makowskid](https://avatars.githubusercontent.com/u/6271194?v=4)](https://github.com/makowskid "makowskid (10 commits)")

---

Tags

phplaravelSharpAPInatural language processingai apicvhr techATSresume matchingjob descriptionjob scorecompatibility scoring

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/sharpapi-laravel-resume-job-match-score/health.svg)

```
[![Health](https://phpackages.com/badges/sharpapi-laravel-resume-job-match-score/health.svg)](https://phpackages.com/packages/sharpapi-laravel-resume-job-match-score)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
