AI-powered API

Hospitality Product Categorization

Generates a list of suitable categories for hospitality products with relevance weights.

Generates a a list of suitable categories for the Hospitality type product with relevance weights as float value (1.0-10.0) where 10 equals 100%, the highest relevance score.

By providing the product name and its parameters, this API delivers the best category matches possible. It is highly useful for populating product catalogues and processing bulk products efficiently.

Ideal for developers working on travel platforms, hotel booking systems, or hospitality marketplaces. It streamlines the categorization of hospitality products, ensuring accuracy and enhancing searchability. Use cases include categorizing new hotel listings, improving the organization of hospitality offerings, and providing users with relevant category suggestions for a better experience.

The weights are provided as float values (1.0-10.0) where 10 equals 100%, the highest relevance score.

Only the content parameter is required.

You can limit the output with the max_quantity parameter.

You can set your preferred writing style by providing an optional voice_tone parameter. It can be adjectives like funny or joyous, or even the name of a famous writer.

Within an additional optional parameter context, you can provide a list of other categories that will be taken into consideration during the mapping process (for example your current categories).

AI jobs involve two key steps:

Submitting the AI job: Initiating the process by sending the job request.
Monitoring and receiving results: Continuously checking the job status and obtaining the final output upon successful completion.

Step 1. Submit the AI Job request

Endpoint: POST - /api/v1/tth/hospitality_product_categories

Attribute	Type	Mandatory	Description
content	String	Yes	Provide the content to generate travel product categories.
city	String	No	Specify the city to travel.
country	String	No	Specify the country to travel.
language	String	No	Specify the language of the output, defaults to `English`.
max_quantity	Number	No	Maximum number of product categories to generate.
voice_tone	String	No	Specify the voice tone. The default will be `neutral`.
context	String	No	The list of other categories that will be taken into consideration during the mapping process (for example your current categories).

Request example:

{
    "content": "Hotel Crystal 大人専用",
    "city": "Tokyo",
    "country":"Japan",
    "language": "English",
    "max_quantity":10,
    "voice_tone": "neutral",
    "context":null
}

RESPONSE EXAMPLE:

{
  "status_url": "https://sharpapi.com/api/v1/content/translate/job/status/5de4887a-0dfd-49b6-8edb-9280e468c210",
  "job_id": "5de4887a-0dfd-49b6-8edb-9280e468c210"
}

Step 2. Monitor & Fetch AI Job Results

An endpoint is used to check on the progress of the requested API job.

RESULT EXAMPLE:

{
  "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
        }
      ]
    }
  }
}

Accelerate integration with our official SDK client packages:

NodeJS SDK

Python SDK

PHP SDK

Laravel SDK

.NET SDK

Flutter SDK

SharpAPI Introduction Video

Feb 2, 2024

SharpAPI is a powerful AI-powered API, which provides a range of workflow automation endpoints to help improve efficiency across various industries. It has features for E-commerce, Content & Marketing Automation, SEO, HR Tech, and Travel & Hospitality industries.

Leveraging AI for Enhanced Online Engagement

Jul 18, 2024

Let’s explore how AI can be leveraged to build scalable solutions for online engagement across various industries seeking to enhance efficiency and productivity through AI-driven workflow automation.

When Laravel/PHP E-commerce App Meets AI

Jan 1, 2024

Hey fellow Laravel enthusiasts! In the ever-evolving landscape of e-commerce, integrating AI into your Laravel applications is not just a luxury, it’s a necessity. With SharpAPI’s Laravel package, it’s now easier than ever. In this blog, I’ll guide you through 10 transformative use cases for enhancing your Laravel-based e-commerce applications using SharpAPI.