README

Hr Related Job Positions API for PHP

💼 Generate related job positions using AI - finds similar positions with scores

Check the full documentation on the Hr Related Job Positions API for PHP API page.

Quick Links

Requirements

• PHP >= 8.0

Installation

Step 1. Install the package via Composer:

composer require sharpapi/php-hr-related-job-positions

Step 2. Visit SharpAPI to get your API key.

Laravel Integration

Building a Laravel application? Check the Laravel package version for better integration.

What it does

Generate related job positions using AI - finds similar positions with scores

Usage

<?php

require __DIR__ . '/vendor/autoload.php';

use SharpAPI\HRRelatedPositions\RelatedJobPositionsClient;
use GuzzleHttp\Exception\GuzzleException;

$apiKey = 'your_api_key_here';
$client = new RelatedJobPositionsClient(apiKey: $apiKey);

try {
    $statusUrl = $client->findRelatedJobPositions(
        content: 'Your text content here',
        language: 'English'
    );

    // Optional: Configure polling
    $client->setApiJobStatusPollingInterval(10);
    $client->setApiJobStatusPollingWait(180);

    // Fetch results (polls automatically)
    $result = $client->fetchResults($statusUrl);
    $resultData = $result->getResultJson();

    echo $resultData;
} catch (GuzzleException $e) {
    echo "API error: " . $e->getMessage();
}

Example Response

{
    "data": {
        "type": "api_job_result",
        "id": "80d0a822-0e2a-40e1-97fd-e7fd62ec9eb0",
        "attributes": {
            "status": "success",
            "type": "hr_related_job_positions",
            "result": {
                "job_position": "Flutter Mobile Developer",
                "related_job_positions": [
                    {
                        "name": "Android Developer",
                        "weight": 8
                    },
                    {
                        "name": "iOS Developer",
                        "weight": 8.5
                    },
                    {
                        "name": "MOBILE APP DEVELOPER",
                        "weight": 9.5
                    },
                    {
                        "name": "React Native Developer",
                        "weight": 7.5
                    },
                    {
                        "name": "Mobile-Entwickler f\u00fcr Flutter",
                        "weight": 10
                    },
                    {
                        "name": "Flutter-App-Entwickler",
                        "weight": 9
                    },
                    {
                        "name": "Mobile-App-Entwickler (Flutter)",
                        "weight": 8
                    },
                    {
                        "name": "Flutter-Entwickler",
                        "weight": 10
                    },
                    {
                        "name": "Cross-Platform Mobile Developer",
                        "weight": 7
                    },
                    {
                        "name": "Mobile-App-Entwickler",
                        "weight": 9
                    },
                    {
                        "name": "Mobile-Entwickler",
                        "weight": 8
                    },
                    {
                        "name": "App-Entwickler",
                        "weight": 7
                    },
                    {
                        "name": "iOS-Entwickler",
                        "weight": 6
                    },
                    {
                        "name": "Flutter Entwickler",
                        "weight": 10
                    },
                    {
                        "name": "Mobile App Entwickler",
                        "weight": 9
                    },
                    {
                        "name": "Android Entwickler",
                        "weight": 8
                    },
                    {
                        "name": "iOS Entwickler",
                        "weight": 7.5
                    }
                ]
            }
        }
    }
}

Changelog

Please see CHANGELOG for more information on what has changed recently.

Credits

• A2Z WEB LTD
• Dawid Makowski
• Boost your PHP AI capabilities!

License

The MIT License (MIT). Please see License File for more information.

Social Media

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

• SharpAPI X (formerly Twitter)
• SharpAPI YouTube
• SharpAPI Vimeo
• SharpAPI LinkedIn
• SharpAPI Facebook