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

Resource	Link
Main API Documentation	Authorization, Webhooks, Polling & More
Postman Documentation	View Docs
Product Details	SharpAPI.com
SDK Libraries	GitHub - SharpAPI SDKs

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 / php-hr-related-job-positions

Maintainers

Details