Travel Hospitality Categorization API for PHP

✈️ Categorize hospitality products using AI - hotels, resorts with relevance scores

Check the full documentation on the Travel Hospitality Categorization 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-travel-hospitality-categorization

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

Categorize hospitality products using AI - hotels, resorts with relevance scores

---

Usage

<?php

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

use SharpAPI\TravelHospitality\HospitalityCategorizationClient;
use GuzzleHttp\Exception\GuzzleException;

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

try {
    $statusUrl = $client->categorizeHospitalityProduct(
        productName: 'Luxury Beach Resort',
        city: 'Miami',
        country: 'United States',
        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": "afb7cc23-23a5-479c-92a9-be983792dabc",
        "attributes": {
            "status": "success",
            "type": "tth_hospitality_product_categories",
            "result": [
                {
                    "name": "Adult Only Hotels",
                    "weight": 10
                },
                {
                    "name": "Luxury Hotels",
                    "weight": 8.5
                },
                {
                    "name": "Boutique Hotels",
                    "weight": 7.5
                },
                {
                    "name": "Romantic Getaways",
                    "weight": 7
                },
                {
                    "name": "City Hotels",
                    "weight": 6.5
                },
                {
                    "name": "Couples Retreats",
                    "weight": 6
                }
            ]
        }
    }
}

---

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