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:

  1. Submitting the AI job: Initiating the process by sending the job request.
  2. 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
        }
      ]
    }
  }
}
SharpAPI Introduction Video

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

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

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.