README

Travel Tours Activities Categorization API for PHP

✈️ Categorize tours and activities using AI - generates category matches with scores

Check the full documentation on the Travel Tours Activities Categorization API for PHP API page.

Quick Links

Requirements

• PHP >= 8.0

Installation

Step 1. Install the package via Composer:

composer require sharpapi/php-travel-tours-activities-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 tours and activities using AI - generates category matches with scores

Usage

<?php

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

use SharpAPI\TravelToursActivities\ToursActivitiesCategorizationClient;
use GuzzleHttp\Exception\GuzzleException;

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

try {
    $statusUrl = $client->categorizeToursActivities(
        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": "55bc3311-d16e-4949-83a0-d367b7f79f89",
        "attributes": {
            "status": "success",
            "type": "tth_ta_product_categories",
            "result": [
                {
                    "name": "Boat Tours",
                    "weight": 9.5
                },
                {
                    "name": "Nature & Wildlife Tours",
                    "weight": 8.7
                },
                {
                    "name": "Water Sports",
                    "weight": 7.8
                },
                {
                    "name": "Sightseeing Cruises",
                    "weight": 9.2
                },
                {
                    "name": "Day Trips",
                    "weight": 8
                },
                {
                    "name": "Eco Tours",
                    "weight": 7.5
                },
                {
                    "name": "Adventure Tours",
                    "weight": 6.8
                },
                {
                    "name": "Cultural Tours",
                    "weight": 6
                },
                {
                    "name": "Multi-day Tours",
                    "weight": 5.5
                },
                {
                    "name": "Private Sightseeing Tours",
                    "weight": 5.2
                }
            ]
        }
    }
}

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