Skip to content

sharpapi/php-travel-tours-activities-categorization

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SharpAPI GitHub cover

Travel Tours Activities Categorization API for PHP

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

Latest Version on Packagist Total Downloads

Check the full documentation on the Travel Tours Activities 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-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


License

License: MIT

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:

About

SharpAPI PHP Client - php-travel-tours-activities-categorization

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages