Check the details at SharpAPI's Resume Parsing API page.
- PHP >= 8.1
- Laravel >= 9.0
Follow these steps to install and set up the SharpAPI Laravel Resume Parser package.
- Install the package via
composer:
composer require sharpapi/laravel-resume-parser-
Register at SharpAPI.com to obtain your API key.
-
Set the API key in your
.envfile:
SHARP_API_KEY=your_api_key_here- [OPTIONAL] Publish the configuration file:
php artisan vendor:publish --tag=sharpapi-resume-parser- Automated Resume Parsing with AI: Efficiently parse and extract structured information from resumes in various formats, including PDF, DOC, DOCX, TXT, and RTF.
- Multi-language Support: Supports 80+ languages for parsing results.
- Consistent Data Format: Ensures predictable JSON structure for parsed data.
- Robust Polling for Results: Polling-based API response handling with customizable intervals.
- API Availability and Quota Check: Check API availability and current usage quotas with
pingandquotaendpoints.
You can inject the ResumeParserService class to access parsing functionalities. For best results, especially with batch processing, use Laravel’s queuing system to optimize job dispatch and result polling.
- Dispatch Job: Send a resume file to the API using
parseResume, which returns a status URL. - Poll for Results: Use
fetchResults($statusUrl)to poll until the job completes or fails. - Process Result: After completion, retrieve the results from the
SharpApiJobobject returned.
Note: Each job typically takes a few seconds to complete. Once completed successfully, the status will update to
success, and you can process the results as JSON, array, or object format.
Here is an example of how to use ResumeParserService within a Laravel controller:
<?php
namespace App\Http\Controllers;
use GuzzleHttp\Exception\GuzzleException;
use SharpAPI\ResumeParser\ResumeParserService;
class ResumeController extends Controller
{
protected ResumeParserService $resumeParserService;
public function __construct(ResumeParserService $resumeParserService)
{
$this->resumeParserService = $resumeParserService;
}
/**
* @throws GuzzleException
*/
public function parseResume()
{
$statusUrl = $this->resumeParserService->parseResume(
'/path/to/resume.pdf',
'English' // OPTIONAL output language, English is the default anyway
);
$result = $this->resumeParserService->fetchResults($statusUrl);
return response()->json($result->getResultJson());
}
}All requests are managed by Guzzle, so it's helpful to be familiar with Guzzle Exceptions.
Example:
use GuzzleHttp\Exception\ClientException;
try {
$statusUrl = $this->resumeParserService->parseResume('/path/to/resume.pdf', 'English');
} catch (ClientException $e) {
echo $e->getMessage();
}You can customize the configuration by setting the following environment variables in your .env file:
SHARP_API_KEY=your_api_key_here
SHARP_API_JOB_STATUS_POLLING_WAIT=180
SHARP_API_JOB_STATUS_USE_POLLING_INTERVAL=true
SHARP_API_JOB_STATUS_POLLING_INTERVAL=10
SHARP_API_BASE_URL=https://sharpapi.com/api/v1Parses a resume in multiple formats and returns structured data points.
$statusUrl = $resumeParserService->parseResume('/path/to/resume.pdf', 'English');Returns information about the subscription, including usage and remaining quota.
$quotaInfo = $resumeParserService->quota();Checks the API availability and server timestamp.
$pingResponse = $resumeParserService->ping();{
"data": {
"type": "api_job_result",
"id": "5a113c4d-38e9-43e5-80f4-ec3fdea3420e",
"attributes": {
"status": "success",
"type": "hr_parse_resume",
"result": {
"positions": [
{
"skills": [
"Acceptance testing",
"Technical investigation",
"Exploratory testing",
"Agile",
"Test environments",
"Test management tools",
"UAT knowledge",
"Writing test reports",
"Organising, conducting and supporting test activities",
"Performance testing",
"Integration testing",
"Rapid response to equipment failures",
"Implementing immediate repairs",
"Participating in audits and reviews",
"Monitoring and reporting repair trends",
"Drawings and documentation updates",
"Executing test cases",
"Documenting results and defects",
"Testing and fault finding finished systems",
"Reporting issues to Test Manager",
"Assisting in software installation",
"Experience of testing Web, PC and mobile based software",
"Understanding iterative software development lifecycle",
"Manual testing methods and processes",
"Technical knowledge of Test Systems hardware and software",
"Planning and task management skills",
"Microsoft operating systems",
"Testing GUI based software"
],
"country": "United Kingdom",
"end_date": null,
"start_date": "2008-06-01",
"job_details": "Responsible for the whole test process from planning, through test plan development, execution & result reporting. Also involved in the development and improvement of the test functions, putting forward suggestions and implementing plans accordingly. Duties included organising, conducting and supporting test activities, performance testing, integration testing, rapid response to equipment failures, implementing immediate repairs, participating in audits and reviews, monitoring and reporting repair trends, updating drawings and documentation, executing test cases, documenting results and defects, testing and fault finding finished systems, reporting issues to Test Manager, and assisting in software installation.",
"company_name": "IT & Telecoms Company",
"position_name": "Test Engineer"
}
],
"candidate_name": "Linda Harris",
"candidate_email": "linda.h@dayjob.co.uk",
"candidate_phone": "02476 000 0000, 0887 222 9999",
"candidate_address": "34 Made Up Road, Coventry, CV66 7RF",
"candidate_language": "English",
"education_qualifications": [
{
"country": "United Kingdom",
"end_date": "2008-06-01",
"start_date": "2005-09-01",
"degree_type": "Bachelor’s Degree or equivalent",
"school_name": "Nuneaton University",
"school_type": "University or equivalent",
"learning_mode": "In-person learning",
"education_details": "",
"faculty_department": "",
"specialization_subjects": "Software Engineering"
},
{
"country": "United Kingdom",
"end_date": "2005-06-01",
"start_date": "2000-09-01",
"degree_type": "High School/Secondary School Diploma or equivalent",
"school_name": "Coventry North School",
"school_type": "High School/Secondary School or equivalent",
"learning_mode": "In-person learning",
"education_details": "A levels: Maths (A), English (B), Technology (B), Science (C)",
"faculty_department": "",
"specialization_subjects": ""
}
],
"candidate_spoken_languages": [
"German"
],
"candidate_honors_and_awards": [],
"candidate_courses_and_certifications": [
"ISEB certification"
]
}
}
}
}For issues or suggestions, please:
Please see CHANGELOG for a detailed list of changes.
- A2Z WEB LTD
- Dawid Makowski
- Enhance your Laravel AI capabilities!
The MIT License (MIT). Please see License File for more information.
Stay updated with news, tutorials, and case studies: